Gemini MCP Server

Give Claude superpowers with Gemini's massive context window. Analyze entire codebases, search the web, process images, and brainstorm ideas—all through MCP.

Quick Start

Prerequisites

1. Install Gemini CLI: npm install -g @google/gemini-cli

2. Authenticate: Run gemini and login with Google (free: 60 req/min, 1000 req/day)

3. Set default model (recommended): export GEMINI_MODEL="gemini-3-pro-preview"

Install

One-Click

Manual

# Claude Code
claude mcp add gemini-cli -- npx -y @tuannvm/gemini-mcp-server

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "gemini-cli": {
      "command": "npx",
      "args": ["-y", "@tuannvm/gemini-mcp-server"]
    }
  }
}

What You Can Do

Tool	What it does
gemini	Analyze files and codebases with Gemini's 1M+ token context
web-search	Search the web with Google Search grounding
analyze-media	Process images, PDFs, and screenshots
shell	Generate and execute shell commands
brainstorm	Creative ideation with structured methodologies

Examples

# Analyze an entire codebase
Use gemini to analyze @. and provide an architecture overview

# Compare files
Use gemini to compare @src/old.ts and @src/new.ts

# Search the web
Use web-search to find the latest React 19 features

# Analyze a screenshot
Use analyze-media with filePath "@error.png" and prompt "what's this error?"

# Brainstorm ideas
Use brainstorm with methodology "design-thinking" to improve user onboarding

Documentation

• API Reference — Full tool parameters and options

• Gemini CLI Integration — Setup, models, and troubleshooting

• Documentation Site

Development

npm install    # Install dependencies
npm run dev    # Development mode
npm run build  # Build
npm test       # Run tests

Acknowledgments

Inspired by gemini-mcp-tool.

Related Projects

• codex-mcp-server — MCP server for OpenAI Codex CLI with AI-powered code analysis and review

License

MIT — This is an unofficial tool, not affiliated with Google.