Gemini API Docs MCP

A Technical Specification and Installation Guide for AI Coding Agents

1. Introduction

The Gemini API Docs MCP is a hosted service operating on the Model Context Protocol (MCP) standard. It is designed to act as a structured semantic bridge, providing large language models (LLMs) and automated coding agents with real-time, low-latency access to the official Google Gemini API documentation.

To maintain accurate documentation, the server automatically reads and updates its indexes from the official Gemini index. All documents are stored in a Cloudflare D1 SQL database and indexed via a SQLite FTS5 virtual table, allowing fast BM25 search queries directly from your development client.

2. Service Specifications

Parameter	Specification Value
Public SSE Endpoint	`https://gemini-docs.dev/mcp`
Platform Environment	Cloudflare Workers, D1 SQL Database
FTS Tokenizer	SQLite `fts5(unicode61)`
Available MCP Tools	`search_documentation(queries)` `get_capability_page(capability)` `get_current_model()`

3. Client Integration Setup

Follow the instructions below to register the remote server into your specific agent's toolset.

3.1. Gemini CLI

The Gemini CLI native environment is the primary client. Install the extension using the CLI's packaging commands:

gemini extensions install stupidloud/gemini-api-docs-mcp

After completing the installation process, restart your Gemini CLI. Verify the connection by invoking the system commands:

/extensions list
/mcp

3.2. Claude Code

Anthropic's Claude Code supports adding remote tools via Server-Sent Events (SSE). Register the server dynamically in your workspace:

claude mcp add --transport sse gemini-docs https://gemini-docs.dev/mcp

Note: The configuration can be scoped to user-level (~/.claude.json) or project-level (.mcp.json) using the --scope option. Verify the tool state within the console via the /mcp command.

3.3. Codex (OpenAI Coding Agent)

For Codex environments, register the server by manually editing your project-scoped config (.codex/config.toml) or global config (~/.codex/config.toml):

[mcp_servers.gemini-docs]
url = "https://gemini-docs.dev/mcp"
enabled = true

Note: If you are using project-scoped configuration, run codex trust to permit tool execution. Restart Codex to load the tools.