> For clean Markdown of any page, append `.md` to the page URL.
> Documentation index: https://you.com/docs/llms.txt (section indexes: append `/llms.txt` to any section URL).
> Search these docs: Docs MCP at https://you.com/docs/_mcp/server (`searchDocs`, no API key).
> Call live You.com APIs: Product MCP at https://api.you.com/mcp (keyless `?profile=free` exposes `you-search` and `you-discover`. Research and finance use `/mcp/research`, `/mcp/finance`, or `?tools=` on `/mcp`). To pick an API or integration path, call `you-discover` on that server instead of guessing.
> OpenAPI: https://you.com/docs/openapi.json—auth header `X-API-Key`, env `YDC_API_KEY`.

# Gemini CLI

Give Gemini CLI real-time web search, content extraction, and citation-backed research through the [You.com MCP Server](/docs/agents/mcp-server). (Yes, Gemini's CLI can use You.com—that's what MCP is for.)

> **Install our docs MCP server**
>
> This documentation ships with a Docs MCP Server that gives any MCP-enabled agent a `searchDocs` tool to search every page here and get back relevant passages with source URLs—no API key required. Point your client at `https://you.com/docs/_mcp/server`. See the [Docs MCP Server guide](/docs/agents/docs-mcp-server) for setup and examples.

## Quick Setup

## Add You.com to Your Gemini CLI Settings

Edit `~/.gemini/settings.json` and add the You.com server under `mcpServers`:

```json
{
  "mcpServers": {
    "you-com": {
      "httpUrl": "https://api.you.com/mcp?profile=free"
    }
  }
}
```

> **Warning**
>
> **Gemini CLI gotcha:** Gemini CLI uses `httpUrl` (not `url`) for streamable HTTP MCP servers. This is different from Claude Code, Cursor, and VS Code.

This uses the free profile: keyless `you-search` and `you-discover`, 100 queries per day, no signup.

## Restart Gemini CLI

```bash
gemini
```

## Verify the Tools Are Loaded

Inside Gemini CLI:

```bash
/mcp list
```

You should see `you-com` listed with `you-search` and `you-discover`. (An API key on `/mcp` adds `you-contents` and `you-balance`. `you-research` and `you-finance` need the dedicated paths or an explicit allowlist.)

## Higher Rate Limits

For higher limits and the default keyed tools on `/mcp` (`you-search`, `you-contents`, `you-balance`, `you-discover`):

```json
{
  "mcpServers": {
    "you-com": {
      "httpUrl": "https://api.you.com/mcp",
      "headers": {
        "Authorization": "Bearer <YDC_API_KEY>"
      }
    }
  }
}
```

Get a key at [you.com/platform](https://you.com/platform).

## Local Install (stdio)

For offline development or self-hosted use:

```json
{
  "mcpServers": {
    "you-com": {
      "command": "npx",
      "args": ["-y", "@youdotcom-oss/mcp"],
      "env": {
        "YDC_API_KEY": "<YDC_API_KEY>"
      }
    }
  }
}
```

Omit `YDC_API_KEY` for free-tier behavior.

## Quick Demo

```text
Search for the three latest changes to the Gemini API and summarize what's new.
```

```text
Research the differences between Vertex AI Search and Google's general web search API, with citations.
```

## Troubleshooting

#### /mcp list shows nothing

Confirm you used `httpUrl`, not `url` or `serverUrl`. Gemini CLI silently ignores unrecognized keys.

#### Server connects but tools fail

Gemini CLI requires tool name allowlisting in some configs. Check `~/.gemini/settings.json` for a `mcpServers.you-com.includeTools` field. Remove it to allow all tools, or add the tool names you need (`you-search`, `you-contents`, `you-discover`, and so on).

#### 401 or invalid key

Regenerate at [you.com/platform](https://you.com/platform) and re-paste, watching for extra whitespace.

#### spawn npx ENOENT

For local installs, install Node.js 18+ and ensure `npx` is on your `PATH`.

## Resources

#### [MCP Server Reference](/docs/agents/mcp-server)

Endpoint, authentication, and full tool reference.

#### [SDKs & Tools Overview](/docs/integrations-overview)

Browse every You.com SDK, agent tool, and integration.