# Connect Nickbox to Gemini

> Use Nickbox with Gemini CLI, with the Gemini app through Spark custom apps, or with the Gemini Enterprise preview.

Updated: 2026-10-03 · Canonical: https://staging.nickbox.io/en/docs/gemini

Nickbox works with Gemini CLI today, and with the Gemini app where Spark custom apps are available.

## Before you start

- A Nickbox account with at least one inbox connected.
- Your MCP URL: `https://nickbox.io/mcp` here; the real one is in the dashboard under Connect.

## Gemini CLI

1. Open `~/.gemini/settings.json` and add Nickbox under `mcpServers`:

   ```json
   {
     "mcpServers": {
       "nickbox": {
         "httpUrl": "https://nickbox.io/mcp"
       }
     }
   }
   ```

   `httpUrl` is the field for Streamable HTTP servers. If the file already has other settings, add only the `nickbox` entry.

2. Start `gemini` and run:

   ```text
   /mcp auth nickbox
   ```

3. Approve read-only access in the browser. Gemini CLI stores the token locally.

## Gemini app (Spark custom apps)

This route is limited. As of this writing it needs a personal Google account, United States, English, and a Google AI Pro or Ultra plan. It does not work with Workspace accounts.

1. Open **Settings**, then **Connected Apps**, then **Custom apps**.
2. Choose **Add a custom app** and paste your MCP URL.
3. Approve read-only access on the Nickbox screen.

Availability and menu names may differ in your version.

## Gemini Enterprise (preview)

An administrator can add a custom MCP server as a connector in Gemini Enterprise. This is a preview feature, so follow Google's current admin documentation and use the Nickbox URL above.

## Check it works

```text
list my inboxes
```

Gemini should call `list_accounts` and return your nicknames.

## Troubleshooting

- **`/mcp` does not list nickbox.** Check the JSON is valid and the file is `~/.gemini/settings.json`. Restart Gemini CLI after editing.
- **Authentication loops.** Run `/mcp auth nickbox` again. If it still fails, delete the saved token for nickbox and retry.
- **No Custom apps in the Gemini app.** Your account, country, language or plan is probably outside the Spark rollout. Use Gemini CLI or another client.
- **Google blocks sign-in on Workspace.** See the [Workspace admin guide](/en/docs/workspace-admin).