M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
G

Gemini MCP Tool

Community
Use Gemini in Claude to analyze large files and codebases.
How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #295 of 438
Stars
★ 2.3k Very popular
Transport
stdio (local process)
Runtime
Node.js 16+ · Prebuilt binary
Credentials
API key / credential required
License
Other / unspecified
Last commit
Tools
4
46FMRS · D

The README describes an unofficial third-party MCP server for Claude Desktop and Claude Code that provides Gemini-based large-file and codebase analysis plus sandbox testing. The README shows an MIT badge and MIT License statement, while the repository metadata lists the license as NOASSERTION.

Strongest · Documentation 12/20 Weakest · Security and permissions 7/20

Reliability
8/20
Security and permissions
7/20
Maintenance
9/20
Documentation
12/20
Setup experience
10/20
Why each score
Reliability 8/20
The README lists ask-gemini, sandbox-test, Ping, and Help with parameters, so the normal startup path is plausible. However, there is no committed test or CI evidence, the server manifest is unavailable, and the retired Gemini CLI, experimental agy backend, potentially unhonored model or sandbox settings, timeout behavior, and failure paths remain uncertain, so points are deducted.
Security and permissions 7/20
The README explicitly says requests are sent through Gemini CLI/agy, and that agy tool execution is not sandboxed in -p mode; sandboxing is optional and there is no evidence of least privilege, clear data boundaries, credential handling, or confirmation for dangerous actions. No credential theft or explicit irreversible default action is shown, but external model transmission and unsandboxed execution risks limit the score.
Maintenance 9/20
The repository is not archived and the README shows release, contribution, and public activity signals. However, the supplied material cannot verify recent commits, release cadence, dependency updates, maintainer identity, a security-response channel, or the actual license file. Metadata says NOASSERTION while the README claims MIT, creating license-evidence inconsistency, so points are deducted.
Documentation 12/20
The README covers installation, client configuration, tool names, key parameters, @ file references, sandbox usage, environment variables, platform examples, and some known limitations. Points are deducted because the full documentation, troubleshooting, authentication, cost information, network data-flow details, and manifest are not supplied; the CLI retirement and prerequisite guidance also introduce temporal and interpretive complexity.
Setup experience 10/20
A one-line npx installation command, Node.js requirement, Gemini/agy prerequisites, Claude Desktop configuration, and verification step are provided, making the mainstream-client path reasonably clear. Points are deducted because users must separately install and authenticate the CLI, backend migration adds complexity, agy is experimental, the Windows example is fragile, and no executable connection evidence is supplied.

Static review · not runListed 2026-07-29

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesRuns commands or codeUses the network

Best for

  • Developers using Claude Desktop or Claude Code
  • Users who need large-file or codebase analysis
  • Users who already have Gemini CLI or agy installed and configured

Not for

  • Users who do not use Claude Desktop or Claude Code
  • Users without the required CLI installed or configured
  • Users who require official Google support or an official integration

Required permissions

  • Access to local files or directories referenced with @ syntax
  • Permission to run the Gemini CLI or agy subprocess
  • Login or API access configured for the selected CLI

Risks and side effects

  • Tool execution in the agy backend is not sandboxed in -p mode
  • Referenced file contents are submitted to the selected CLI backend for analysis
  • The agy backend may not fully honor requested model or sandbox settings; the tool reports a notice
  • Quota, authentication, and CLI errors may be returned verbatim

Setup

Before you start

Runtime：Node.js 16+ · Prebuilt binary

Other optional settings (3)
GEMINI_MCP_BACKEND optional Selects the backend: gemini or agy/antigravity; unset uses the date-aware default (agy from 2026-06-18).
AGY_CLI_PATH optional Full path to the agy binary if it isn't on the server's PATH.
GEMINI_MCP_TIMEOUT optional Overall CLI run timeout in minutes (default 45).

Install Node.js 16 or later and install and configure Gemini CLI; affected users may instead install Antigravity CLI (agy) and sign in. Register the server with claude mcp add gemini-cli -- npx -y gemini-mcp-tool, or add the provided configuration to Claude Desktop and restart the terminal session. Enterprise, Standard-license, or paid-API-key users retaining Gemini CLI access can set GEMINI_MCP_BACKEND=gemini.

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "gemini-cli": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add gemini-cli -- npx -y gemini-mcp-tool

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

Type /mcp inside Claude Code to verify the gemini-cli MCP is active; the ask-gemini, sandbox-test, Ping, and Help tools should appear in the client's tool list.

Troubleshooting

  1. Run `/mcp` in Claude Code to confirm the server is active
  2. Verify that Node.js is version 16 or later
  3. Verify that Gemini CLI or agy is installed, executable, and signed in
  4. Set `AGY_CLI_PATH` if agy is not on PATH
  5. Check that `GEMINI_MCP_BACKEND` is `gemini`, `agy`, or `antigravity`
  6. Check `GEMINI_MCP_TIMEOUT` when needed; the default timeout is 45 minutes

Things to try

Once connected, you can ask your AI assistant things like:

  • ask gemini to analyze @src/main.js and explain what it does
  • use gemini to summarize @ the current directory
  • use gemini sandbox to create and run a Python script that processes data
  • ask gemini to search for the latest tech news

Tools 4

ask-gemini read-only
Sends general questions or complex analysis requests to Gemini, with optional file or directory references using @ syntax and optional model and sandbox parameters.
sandbox-test writes
Tests code or commands in Gemini sandbox mode; it always runs with sandbox enabled.
Ping read-only
Echoes a message to test the connection.
Help read-only
Displays Gemini CLI help text.

Use cases

Analyze large files or codebases
Explain files and directories with @ references
Ask Gemini for an additional perspective
Test code or scripts in sandbox mode

Supported clients

Claude Desktop
Claude Code

Listed from the project's documentation, not tested by this site.

Overview

Gemini MCP Tool is an unofficial third-party MCP server that lets AI assistants ask questions through the Gemini CLI or, by default, the Antigravity CLI (agy), analyze files and codebases, and use Gemini's large token window for large analysis tasks.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →
Compare with other MCP servers

Source revision 588e73dfff07 Data synced 2026-10-19 Read the FMRS scoring method