gemini-cli-mcp

MCP server that bridges Claude Code to the Gemini CLI — use Gemini models directly from Claude Code with zero extra API costs.

Why?

Google's Gemini Pro/Advanced plan gives you unlimited access to Gemini models through the CLI, but doesn't provide free API tokens. This MCP wraps the CLI so Claude Code can call Gemini directly — no API key, no extra cost.

This lets you:

• Use Gemini 3.1 Pro, 2.5 Pro, 2.5 Flash, 2.5 Flash-Lite from Claude Code
• Use Nano Banana 2 (image generation via Gemini 3.1 Flash Image)
• Integrate Gemini as a second-opinion or auxiliary model alongside Claude
• Build local agent systems combining Claude + Gemini without cloud API costs
• Pay $0 extra — it runs on your existing Gemini plan

How it works

Claude Code → MCP Protocol → gemini-cli-mcp → gemini -p "prompt" → response → Claude Code

By default, the Gemini CLI uses auto mode — it picks the best model for each task. You can optionally specify a model if needed.

Available Models

Model ID	Description
auto (default)	Gemini auto-selects the best model
gemini-3.1-pro-preview	Latest flagship, reasoning/agentic
gemini-2.5-pro	Stable pro, complex tasks
gemini-2.5-flash	Fast, great value, 1M context
gemini-2.5-flash-lite	Lightest/fastest

Quick Start

1. Install Gemini CLI

npm install -g @google/gemini-cli

Authenticate:

gemini

2. Add the MCP to Claude Code

claude mcp add gemini-cli -- npx -y @gitdavidjr/gemini-cli-mcp

3. Restart Claude Code

4. Use it

Use gemini_prompt: "explain quantum computing in 2 sentences"

To use a specific model:

Use gemini_prompt with prompt "summarize this" and model "gemini-2.5-flash-lite"

License

ISC