> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/mcp/introduction/getting-started/gemini-cli/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Gemini CLI

[Gemini CLI](https://github.com/google-gemini/gemini-cli) supports MCP server connections through its settings configuration. Both OAuth and API key authentication are supported.

## Requirements

* Gemini CLI installed and configured with your Google account.
* [Node.js LTS](https://nodejs.org/en) installed locally.
* An Ada dashboard account. Available tools depend on your role — see [Permissions](/mcp/introduction/authentication#permissions).

Gemini CLI uses the `mcp-remote` helper to connect to HTTP-based MCP servers. Pin the helper version. See [Authentication](/mcp/introduction/authentication#pin-the-local-helper-version).

If prompted, allow `npx` to install it automatically, or install it manually:

```bash
npm install -g mcp-remote@0.2.5
```

## Option 1: OAuth (recommended)

1. Open your Gemini CLI settings file at `~/.gemini/settings.json`.

2. Add the following configuration under the existing `mcpServers` section (or create one if it does not exist):

   ```json
   {
     "mcpServers": {
       "ada": {
         "command": "npx",
         "args": ["mcp-remote@0.2.5", "https://acme-corp.ada.support/api/mcp/oauth"]
       }
     }
   }
   ```

3. Replace `acme-corp.ada.support` with your Ada instance domain. MCP routing is based on subdomain.

4. Restart Gemini CLI.

5. When you first attempt to use an Ada MCP tool, Gemini CLI detects the OAuth challenge from the server. If authentication is required, run:

   ```bash
   /mcp auth ada
   ```

   This opens a browser window to complete the OAuth login flow. After authentication completes, retry your request.

## Option 2: API key

API key authentication uses a token generated from your Ada dashboard. This is useful for automated setups or when browser-based login is not available.

> **Tip**
>
> For security, prefer setting the API key as an environment variable outside of `settings.json` rather than pasting it directly into the file.

1. Generate an API key from **Config > PLATFORM > API keys** in your Ada dashboard.

2. Set the API key as an environment variable:

   ```bash
   export ADA_API_KEY=your_api_key_here
   ```

3. Open your Gemini CLI settings file at `~/.gemini/settings.json`.

4. Add the following configuration under the existing `mcpServers` section (or create one if it does not exist):

   ```json
   {
     "mcpServers": {
       "ada": {
         "command": "npx",
         "args": [
           "mcp-remote@0.2.5",
           "https://acme-corp.ada.support/api/mcp",
           "--header",
           "Authorization: Bearer ${ADA_API_KEY}"
         ]
       }
     }
   }
   ```

5. Replace `acme-corp.ada.support` with your Ada instance domain (see [Authentication](/mcp/introduction/authentication)).

6. Restart Gemini CLI.