How do I install the gemini mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `PROJECT_ROOT`, `GEMINI_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Gemini MCP Server

Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage

Local serverstdioGo

What is the Gemini MCP Server?

Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage

What the server does

A lightweight, stateless MCP (Model Context Protocol) server that lets developer agents (Claude Code, GitHub Copilot) hand off deep repository analysis to the Gemini CLI. The server is read-only, returns structured JSON (as text content), and is designed to reduce the calling agent's context and model usage.

Gemini Researcher accepts queries from your AI agent and uses Gemini CLI to analyze your local code files. Results are returned as formatted JSON for your agent to use.

Credentials and setup notes

Node.js 18+ installed - Gemini CLI installed: npm install -g @google/gemini-cli - Gemini CLI authenticated (recommended: gemini → Login with Google) or set GEMINI_API_KEY Quick checks:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
quick_query	flash -> flash_lite -> auto
deep_research	pro -> flash -> flash_lite -> auto
analyze_directory	flash -> flash_lite -> auto
validate_paths	Pre-check file paths
health_check	Diagnostics
fetch_chunk	Get chunked responses

How to install the Gemini MCP Server

{
  "mcpServers": {
    "gemini-researcher": {
      "command": "npx",
      "args": ["-y", "gemini-researcher"],
      "env": {
        "PROJECT_ROOT": "your-value",
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Node.js 18+ installed - Gemini CLI installed: npm install -g @google/gemini-cli - Gemini CLI authenticated (recommended: gemini → Login with Google) or set GEMINI_API_KEY Quick checks:

Variable	Description	Required
PROJECT_ROOT	Configuration value read at startup.	Optional
GEMINI_API_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Gemini to quick query.”
“Use Gemini to deep research.”
“Use Gemini to analyze directory.”

Frequently asked questions

Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Gemini MCP Server

Filesystem

Official

Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.

File Systems & StorageTypeScript★ 63.0k

Context7

Official

Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.

Documentation & API ReferencesRemoteTypeScript★ 32.0k

Stacksfinder

Deterministic tech stack recommendations, audits, and project estimates. No hallucinations.

Developer ToolsRemoteTypeScript

MCP RAG Server

SOTA family roadmap: docs/roadmap/sota-family-roadmap.md.

Developer Tools

Robinhood

TypeScript SDK for the MadeOnSol Robinhood Chain (chain id 4663) API — EVM-native KOL trades, the DEX trade tape, token discovery/bundles/candles