Gemini

io.github.PavelGuzenfeldPublished by GitHub account PavelGuzenfeldv0.1.2Updated Oct 24, 2026

MCP server that exposes Google Gemini as tools for Claude Code

VerifiedSTDIODesktop onlyDeveloper ToolsAI & ML

Overview

AI-generated overview

Local MCP server that exposes Google Gemini models as tools so an assistant can ask questions, analyze code, and hold multi-turn chats.

What you can do
  • Ask Gemini a question or hand it a task
  • Send code or text for analysis with a specific instruction
  • Run multi-turn conversations with full message history
  • List available Gemini models and override the model per call
When to use it
Useful when you want a second model's opinion, a large-context pass over code or text, a code review from a different perspective, or a quick summary of logs without leaving the assistant.
Requirements
Runs as a local Node.js process, installed by cloning the repository or via npx. Requires a Google AI Studio API key supplied in the GEMINI_API_KEY environment variable; an optional GEMINI_MODEL variable sets the default model. Network access to Google's generative language API is needed.
Before you install
The API key is passed in plain text in the client configuration, so keep that file private. Prompts, code and text sent to the tools go to Google's Gemini API as a third party. Usage may be subject to Google's quotas and billing terms.

Installation

In SourceWeft

  1. Open Gemini in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

gemini-mcp

[npm] [MCP Registry] [Node.js] [License: MIT]

Lightweight MCP server that exposes Google Gemini as tools for Claude Code (or any MCP client).

Use Gemini for second opinions, large-context analysis, code review, or anything where a different model perspective helps.

Tools

ToolDescription
gemini_askAsk Gemini a question or give it a task
gemini_analyzeSend code/text for analysis with a specific instruction
gemini_chatMulti-turn conversation with full history
gemini_modelsList available Gemini models

Quick Start

1. Get an API key

Go to Google AI Studio and create a free API key.

2. Install

Option A — Clone (recommended for Claude Code)

bash
git clone https://github.com/PavelGuzenfeld/gemini-mcp.git ~/.claude/mcp-servers/geminicd ~/.claude/mcp-servers/gemininpm install

Option B — npx (no install)

bash
npx claude-gemini-mcp

3. Register with Claude Code

Add to ~/.claude/settings.json:

json
{  "mcpServers": {    "gemini": {      "command": "node",      "args": ["/home/you/.claude/mcp-servers/gemini/index.js"],      "env": {        "GEMINI_API_KEY": "your-key-here"      }    }  }}

Or with npx:

json
{  "mcpServers": {    "gemini": {      "command": "npx",      "args": ["-y", "claude-gemini-mcp"],      "env": {        "GEMINI_API_KEY": "your-key-here"      }    }  }}

Usage Examples

Ask a question

> Use gemini_ask to explain the difference between std::expected and std::optional
Gemini says: std::optional<T> represents a value that may or may not be present...std::expected<T, E> additionally carries an error value when the expected value is absent...

Analyze code

> Use gemini_analyze to review this function for performance issues:  instruction: "Find performance bottlenecks"  content: <your code here>
Gemini says: Line 12 allocates inside the loop — move the vector outside...

Multi-turn conversation

> Use gemini_chat with messages:  [{"role": "user", "content": "Design a REST API for a task manager"},   {"role": "model", "content": "Here's a RESTful design..."},   {"role": "user", "content": "Now add authentication"}]
Gemini says: Building on the previous design, add JWT-based auth...

Override model per call

> Use gemini_ask with model: "gemini-2.5-flash" to quickly summarize this error log

Environment Variables

VariableDefaultDescription
GEMINI_API_KEY(required)Google AI Studio API key
GEMINI_MODELgemini-2.5-proDefault model for all tools

Models

ModelBest for
gemini-2.5-proBest quality, large context (1M tokens)
gemini-2.5-flashFast, good for most tasks
gemini-2.0-flashFastest, simple tasks

Every tool accepts an optional model parameter to override the default per-call.

Features

  • Retry with exponential backoff on rate limits (429) and server errors (5xx)
  • Graceful error reporting back to the MCP client (no crashes)
  • Per-call model override
  • Zero configuration beyond the API key

Troubleshooting

ProblemSolution
GEMINI_API_KEY is not setAdd the key to your env block in settings.json
429 Too Many RequestsBuilt-in retry handles this — wait a few seconds
Model not foundRun gemini_models to list valid model names
Tools not appearing in Claude CodeCheck ~/.claude/settings.json syntax, restart Claude Code
ECONNREFUSEDCheck network/firewall — the server calls generativelanguage.googleapis.com

Development

bash
git clone https://github.com/PavelGuzenfeld/gemini-mcp.gitcd gemini-mcpnpm installnpm test          # Run smoke testsnode index.js     # Start the MCP server locally

License

MIT

Source: README.md at commit 5532298

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts