> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini

> Add Spiral to the Gemini app as a custom connected app: paste one link, sign in, no API key.

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](https://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](https://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:

```text theme={null}
https://api.spiral.ai/mcp
```

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:

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

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**

```bash theme={null}
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

**2. Sign in**

Start `gemini` and run:

```text theme={null}
/mcp auth spiral
```

Sign in to Spiral in the browser and click **Authorize**. No API key.

**3. Try a starter prompt**

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

> [accordion] With an API key instead
>
> Create a key under **API keys** in the [console](https://spiral.ai/start) and keep it in the `SPIRAL_API_KEY`
> environment variable. Then add the server with the key as a header:
>
> ```bash theme={null}
> gemini mcp add --scope user --transport http \
>   --header "Authorization: Bearer $SPIRAL_API_KEY" \
>   spiral https://api.spiral.ai/mcp
> ```
>
> 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](/docs/mcp-server.md#troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.