A Model Context Protocol (MCP) server that bridges Claude with Google Gemini, enabling analysis of large files and codebases that exceed Claude's context window.

Why This Exists

Claude has excellent reasoning capabilities but a limited context window. Gemini offers a massive 1M+ token window. This tool lets Claude delegate large file analysis to Gemini while maintaining conversation context.

Tools

ask-gemini

Query Gemini with file references using the @ syntax. Supports session continuity for multi-turn conversations and change mode for structured edit suggestions.

text
ask gemini to analyze @src/main.js
use gemini to summarize @.
analyze @package.json dependencies

brainstorm

Creative ideation with multiple methodologies:

Divergent - Generate many ideas
Convergent - Refine existing ideas
SCAMPER - Systematic creative triggers
Design Thinking - Human-centered approach
Lateral - Unexpected connections

review-code

Interactive code review with git-aware session management:

Multiple review types (security, performance, quality, architecture)
Severity filtering (critical-only, important-and-above, all)
Comment decision tracking (accept, reject, modify, defer)
Structured feedback with numbered comments

Installation

bash
# Recommended
claude mcp add gemini-cli -- npx -y maxanatsko/gemini-mcp-tool

# Verify installation
/mcp

Claude Desktop Configuration

json
{
  "mcpServers": {
    "gemini-cli": {
      "command": "npx",
      "args": ["-y", "maxanatsko/gemini-mcp-tool"]
    }
  }
}

Session Management

The tool maintains conversation history across rounds:

ask-gemini: 7-day TTL, 50 max sessions
brainstorm: 14-day TTL, 30 max sessions
review-code: 24-hour TTL, 20 max sessions

Sessions are stored in ~/.gemini-mcp/sessions/.

Model Selection

Supports multiple Gemini models with automatic fallback:

gemini-3-pro-preview (default)
gemini-3-flash-preview
gemini-2.5-pro
gemini-2.5-flash

Repository

View the source code on GitHub or install from npm.

Gemini MCP Tool