Connect Nickbox to 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:

   {
     "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:

   /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

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.