Claude Code Gemini MCP
MCP Server that enables Claude Code to call Gemini models through OpenAI-compatible API.
Installation
git clone https://github.com/shun-sfoo/claude-code-gemini-mcp.git
cd claude-code-gemini-mcp
npm install
npm run build
Configuration
Environment Variables
| Variable | Description | Required |
|---|---|---|
GEMINI_API_KEY | Your API key | Yes |
GEMINI_BASE_URL | API endpoint (OpenAI-compatible) | Yes |
GEMINI_MODEL | Model ID (default: gemini-3-pro-preview) | No |
Claude Code Integration
Add to your project's .mcp.json:
{
"mcpServers": {
"gemini": {
"command": "node",
"args": ["/path/to/claude-code-gemini-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-api-key",
"GEMINI_BASE_URL": "https://your-api-endpoint/v1",
"GEMINI_MODEL": "gemini-3-pro-preview"
}
}
}
}
Or add to global settings (~/.claude/settings.json).
Available Tools
gemini_think
Deep analysis and reasoning for complex problems.
Parameters:
problem(string, required) - The problem to analyzecontext(string, optional) - Background informationthinkingStyle(string, optional) - One of:analytical,creative,critical,systematic
gemini_brainstorm
Generate multiple creative ideas with pros and cons.
Parameters:
topic(string, required) - The topic to brainstormconstraints(string, optional) - Constraints or requirementscount(number, optional) - Number of ideas, 3-10 (default: 5)
gemini_review
Code, architecture, security, or performance review.
Parameters:
content(string, required) - Content to reviewreviewType(string, required) - One of:code,architecture,security,performancefocus(string, optional) - Specific aspects to focus on
gemini_query
General purpose query with full control.
Parameters:
prompt(string, required) - The prompt to sendsystemPrompt(string, optional) - System prompttemperature(number, optional) - 0-2 (default: 0.7)
Testing
# Create .env file first
cp .env.example .env
# Edit .env with your credentials
# Run tests
npm test
Development
npm run dev # Watch mode
npm run build # Build
npm test # Run tests
License
MIT