Skip to main content
Gemini lets you add a custom app by its MCP server URL. You add it once in the Gemini web app at gemini.google.com, and it then works in the Gemini mobile app too. Custom apps need a personal Google Account (not a work or school one), Keep Activity turned on, and for now an account in the US held by someone 18 or over. They work in English only.
1

Open Connected Apps

On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don’t see Connected Apps, click Personal Intelligence first, then Connected Apps.
2

Add Spiral as a custom app

Under Custom apps, click Add a custom app and paste this MCP server URL:
Leave the credentials under Advanced features empty: Gemini registers itself with Spiral. Click Next.
3

Sign in to Spiral and approve

Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.
4

Try a starter prompt

Type @, pick Spiral so Gemini uses it, and paste:
To stop using Spiral, open Settings › Connected Apps, find Spiral under Custom apps and turn it off. More details › Remove app removes it and unlinks it from your Google Account.

Gemini CLI

1

Add the server

2

Sign in

Start gemini and run:
Sign in to Spiral in the browser and click Authorize. No API key.
3

Try a starter prompt

Create a key under API keys in the console and keep it in the SPIRAL_API_KEY environment variable. Then add the server with the key as a header:
Your shell puts the key into ~/.gemini/settings.json. Keep that file private. The Gemini app takes no API key, only the sign-in.
If something does not work, see Troubleshooting.