Claude Code Gemini MCP
Enables calling Gemini models through an OpenAI-compatible API, providing tools for deep analysis, brainstorming, code review, and general queries using Gemini's language models.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Claude Code Gemini MCPbrainstorm 5 ideas for a new productivity app with gamification elements"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildRelated MCP server: Claude-to-Gemini MCP Server
Configuration
Environment Variables
Variable | Description | Required |
| Your API key | Yes |
| API endpoint (OpenAI-compatible) | Yes |
| Model ID (default: | 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 testDevelopment
npm run dev # Watch mode
npm run build # Build
npm test # Run testsLicense
MIT
Available Tools
4 toolsgemini_brainstormC
Let Gemini brainstorm on a topic and generate multiple creative ideas or solutions with pros and cons
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | The topic to brainstorm | |
| constraints | No | Constraints or requirements to consider | |
| count | No | Number of ideas to generate (default: 5) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. While it mentions generating 'multiple creative ideas or solutions with pros and cons', it lacks details about the tool's behavior: no information about response format, potential limitations, error conditions, or how it interacts with the Gemini model. For a creative generation tool with zero annotation coverage, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that clearly states the tool's purpose. It's appropriately concise with no wasted words, though it could be slightly more structured by separating purpose from output characteristics.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a creative brainstorming tool with no annotations and no output schema, the description is incomplete. It doesn't explain what the output looks like (format, structure of pros/cons), potential limitations of the brainstorming, or how the tool handles different types of topics. For a tool that generates creative content, more context is needed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already fully documents all three parameters (topic, constraints, count). The description doesn't add any parameter-specific information beyond what's in the schema. The baseline score of 3 is appropriate when the schema does all the parameter documentation work.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Let Gemini brainstorm on a topic and generate multiple creative ideas or solutions with pros and cons'. It specifies the verb ('brainstorm', 'generate'), resource ('ideas or solutions'), and output characteristics ('with pros and cons'). However, it doesn't explicitly differentiate from sibling tools like gemini_query, gemini_review, or gemini_think, which likely have different functions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. There's no mention of when this tool is appropriate, when it should not be used, or how it differs from sibling tools like gemini_query, gemini_review, or gemini_think. The agent must infer usage from the purpose alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gemini_queryC
Send any query to Gemini-3-pro-preview model
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | The complete prompt to send | |
| systemPrompt | No | Optional system prompt | |
| temperature | No | Sampling temperature (0-2), default 0.7 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden but offers minimal behavioral insight. It states the tool sends queries but doesn't disclose rate limits, authentication needs, response format, error conditions, or whether it's idempotent. For a model interaction tool, this leaves critical operational details unspecified.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that immediately conveys the core function. Every word earns its place with no redundancy or unnecessary elaboration, making it easy to parse and understand at a glance.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given this is a model query tool with no annotations and no output schema, the description is insufficient. It doesn't explain what kind of response to expect, potential limitations (e.g., token limits), or how it differs from sibling tools. The agent lacks critical context for effective tool selection and invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema fully documents all three parameters. The description adds no parameter-specific information beyond implying 'prompt' is the main input. This meets the baseline for high schema coverage but doesn't enhance understanding of parameter relationships or usage patterns.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Send any query') and target resource ('Gemini-3-pro-preview model'), making the purpose immediately understandable. However, it doesn't differentiate this tool from its siblings (gemini_brainstorm, gemini_review, gemini_think), which likely also interact with Gemini models but for more specific purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus its siblings. It doesn't specify if this is for general-purpose queries while siblings are for specialized tasks, or if there are any prerequisites or constraints. The agent must infer usage from tool names alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gemini_reviewC
Let Gemini review code, architecture design, or technical solutions
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | The content to review (code, design document, etc.) | |
| reviewType | Yes | Type of review: code, architecture, security, or performance | |
| focus | No | Specific aspects to focus on |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the action ('review') but doesn't describe what the review entails (e.g., format of feedback, length, or any limitations like rate limits, authentication needs, or potential side effects). This leaves significant gaps in understanding how the tool behaves beyond its basic function.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence: 'Let Gemini review code, architecture design, or technical solutions.' It is front-loaded with the core purpose and avoids unnecessary words, making it highly concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a review tool with no annotations and no output schema, the description is incomplete. It lacks details on behavioral traits, output format, or any constraints. While the schema covers parameters well, the overall context for effective tool use is insufficient, especially for a tool that likely produces detailed feedback.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, providing clear details for all parameters (content, reviewType, focus). The description doesn't add any semantic information beyond what's in the schema, such as examples or contextual usage tips. With high schema coverage, the baseline score of 3 is appropriate as the schema adequately documents the parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Let Gemini review code, architecture design, or technical solutions.' It specifies the verb ('review') and the resources (code, architecture design, technical solutions). However, it doesn't explicitly differentiate from sibling tools like gemini_brainstorm, gemini_query, or gemini_think, which likely have different purposes (e.g., brainstorming ideas, answering queries, or analytical thinking).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools or other contexts, nor does it specify prerequisites or exclusions. Usage is implied by the purpose but lacks explicit instructions for selection among available options.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gemini_thinkC
Let Gemini-3-pro-preview deeply analyze complex problems, perform reasoning and brainstorming
| Name | Required | Description | Default |
|---|---|---|---|
| problem | Yes | The problem or task to analyze | |
| context | No | Related background information or context | |
| thinkingStyle | No | Thinking style: analytical (logical analysis), creative (divergent thinking), critical (critical evaluation), systematic (systematic decomposition) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions 'deeply analyze' and 'perform reasoning and brainstorming', but doesn't describe what this entails operationally—e.g., whether it's a one-step process, if it involves iterative thinking, what the output format might be, or any limitations like token usage or time constraints. For a tool with no annotations, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core purpose ('Let Gemini-3-pro-preview deeply analyze complex problems') and adds key capabilities ('perform reasoning and brainstorming'). There's no wasted text, and every word earns its place in conveying the tool's intent.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a tool for 'deep analysis' with no annotations and no output schema, the description is insufficient. It doesn't explain what the tool returns (e.g., structured reasoning steps, a summary), how it handles different thinking styles, or any behavioral traits. For a tool with 3 parameters and no structured output, more context is needed to guide effective use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters (problem, context, thinkingStyle) with clear descriptions and an enum for thinkingStyle. The description adds no additional meaning beyond what the schema provides, such as examples or nuanced usage of parameters. Baseline 3 is appropriate when the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'deeply analyze complex problems, perform reasoning and brainstorming' using 'Gemini-3-pro-preview'. It specifies the verb (analyze/reason/brainstorm) and resource (complex problems), but doesn't explicitly differentiate from sibling tools like gemini_brainstorm or gemini_query, which likely have overlapping functions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus its siblings (gemini_brainstorm, gemini_query, gemini_review). It implies usage for 'complex problems' requiring 'deep analysis' but doesn't specify alternatives, exclusions, or prerequisites, leaving the agent to guess based on tool names alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
4 tool updates
v1.0.0- First observed
gemini_brainstorm - First observed
gemini_query - First observed
gemini_review - First observed
gemini_think
TDQS
Multiple tools have overlapping purposes that could cause confusion. gemini_brainstorm and gemini_think both involve generating ideas and analysis, while gemini_query is a general-purpose tool that could potentially cover the same ground. The descriptions don't clearly differentiate when to use each tool versus the others.
All tools follow a perfect gemini_verb pattern consistently throughout. The naming is completely predictable and follows the same structure for every tool, making it easy to understand the pattern.
With only 4 tools, the server feels somewhat thin for a general-purpose AI assistant interface. While the count isn't extreme, it's borderline minimal for what appears to be a Gemini API wrapper that could benefit from more specialized operations.
There are significant gaps in the tool surface for a Gemini API wrapper. Missing are basic operations like summarization, translation, content generation, or structured output formatting. The tools focus narrowly on brainstorming/thinking/review while omitting many common LLM use cases that agents would expect.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
Connect Claude to Fathom meeting recordings, transcripts, and summaries
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Claude makes real phone calls for you — in many languages, with transcript and outcome back in chat.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects Claude Code with Google's Gemini AI, allowing users to ask Gemini questions, get code reviews, and brainstorm ideas directly within Claude Code.248MIT
- AlicenseBqualityDmaintenanceEnables Claude to use Google Gemini as a secondary AI through MCP for large-scale codebase analysis and complex reasoning tasks. Supports both Gemini Flash and Pro models with specialized functions for general queries and comprehensive code analysis.4MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to interact with Google's Gemini API, allowing users to query Gemini models directly or facilitate conversations between Claude and Gemini with conversation history management.70MIT
- AlicenseNot gradedqualityDmaintenanceEnables integration with Gemini AI through Claude Code, providing tools to execute queries to Gemini including basic requests and unsafe operations with auto-confirmation.831ISC
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ShunL12324/claude-code-gemini-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server