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

# Gemini CLI

> Add the Quotable MCP server to Gemini CLI with gemini mcp add or settings.json, using the Streamable HTTP transport and your API key.

Gemini CLI connects to remote MCP servers over Streamable HTTP with custom headers.

## Before you start

* A Quotable API key from **Settings → API keys**. See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md).
* The key in an environment variable:

  ```bash theme={"system"}
  export QUOTABLE_API_KEY="quotable_live_…"
  ```

## Add the server

> [tab] Command
>
> ```bash theme={"system"}
> gemini mcp add --transport http --scope user \
>   --header "Authorization: Bearer $QUOTABLE_API_KEY" \
>   quotable https://app.usequotable.com/api/mcp
> ```
>
> `--scope user` writes to `~/.gemini/settings.json` so Quotable is available everywhere. Without it, the command writes to the current project's `.gemini/settings.json`. Your shell expands `$QUOTABLE_API_KEY` when you run the command, so the key is saved in that file.

> [tab] settings.json
>
> Edit `~/.gemini/settings.json` (all projects) or `.gemini/settings.json` (one project). Use `httpUrl` for Streamable HTTP:
>
> ```json settings.json theme={"system"}
> {
>   "mcpServers": {
>     "quotable": {
>       "httpUrl": "https://app.usequotable.com/api/mcp",
>       "headers": {
>         "Authorization": "Bearer ${QUOTABLE_API_KEY}"
>       }
>     }
>   }
> }
> ```
>
> Gemini CLI resolves `${QUOTABLE_API_KEY}` from your environment when it loads settings, so the key stays out of the file.

> [!WARNING]
>
> Use `httpUrl`, not `url`. In Gemini CLI, `url` selects the older SSE transport, which Quotable doesn't serve.

## Check the connection

Start Gemini CLI and run `/mcp`. Quotable should be listed as connected with its tools and their descriptions.

## Try it

```text theme={"system"}
Using Quotable, list the demand terms behind my brand's prompts with the highest AI volume, and the month each figure describes.
```

Gemini CLI asks for confirmation before each tool call unless you set `"trust": true` on the server. Leave confirmation on: every Quotable tool reads data except `run_agent`, which starts an agent run and uses your workspace's credits, and confirmation lets you see each call.

## Next steps

> [card] [Example prompts](https://docs.usequotable.com/mcp-server/example-prompts.md)
>
> Ready-to-use questions for your workspace.

> [card] [Workflows](https://docs.usequotable.com/mcp-server/workflows.md)
>
> Multi-step recipes for the terminal.

> [card] [Tools reference](https://docs.usequotable.com/mcp-server/tools.md)
>
> Inputs and outputs for each tool.


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