Skip to main content
Glama
ShunL12324

Claude Code Gemini MCP

by ShunL12324

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

Related MCP server: Claude-to-Gemini MCP Server

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 analyze

  • context (string, optional) - Background information

  • thinkingStyle (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 brainstorm

  • constraints (string, optional) - Constraints or requirements

  • count (number, optional) - Number of ideas, 3-10 (default: 5)

gemini_review

Code, architecture, security, or performance review.

Parameters:

  • content (string, required) - Content to review

  • reviewType (string, required) - One of: code, architecture, security, performance

  • focus (string, optional) - Specific aspects to focus on

gemini_query

General purpose query with full control.

Parameters:

  • prompt (string, required) - The prompt to send

  • systemPrompt (string, optional) - System prompt

  • temperature (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

Available Tools

4 tools
gemini_brainstormC

Let Gemini brainstorm on a topic and generate multiple creative ideas or solutions with pros and cons

ParametersJSON Schema
NameRequiredDescriptionDefault
topicYesThe topic to brainstorm
constraintsNoConstraints or requirements to consider
countNoNumber of ideas to generate (default: 5)

TDQS

C2.9/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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

ParametersJSON Schema
NameRequiredDescriptionDefault
promptYesThe complete prompt to send
systemPromptNoOptional system prompt
temperatureNoSampling temperature (0-2), default 0.7

TDQS

C2.9/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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

ParametersJSON Schema
NameRequiredDescriptionDefault
contentYesThe content to review (code, design document, etc.)
reviewTypeYesType of review: code, architecture, security, or performance
focusNoSpecific aspects to focus on

TDQS

C2.9/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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

ParametersJSON Schema
NameRequiredDescriptionDefault
problemYesThe problem or task to analyze
contextNoRelated background information or context
thinkingStyleNoThinking style: analytical (logical analysis), creative (divergent thinking), critical (critical evaluation), systematic (systematic decomposition)

TDQS

C2.9/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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.

  1. 4 tool updatesv1.0.0
    • First observedgemini_brainstorm
    • First observedgemini_query
    • First observedgemini_review
    • First observedgemini_think

TDQS

C2.9/5.0
Disambiguation2/5

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.

Naming Consistency5/5

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.

Tool Count3/5

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.

Completeness2/5

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

ActivityInactive
ResponsivenessNo issues

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

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables 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.
    70
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables integration with Gemini AI through Claude Code, providing tools to execute queries to Gemini including basic requests and unsafe operations with auto-confirmation.
    83
    1
    ISC

Latest Blog Posts

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