claudeers.
// Uncategorized / Others

gemini-mcp-tool

MCP server that enables AI assistants to interact with Google Gemini CLI, leveraging Gemini's massive token window for large file analysis and codebase under…

// Uncategorized / Others[ cli ][ api ][ desktop ][ web ][ claude ]#claude#ai#cli#codebase-analysis#file-analysis#gemini#mcp#model-context-protocol#uncategorized◷ NOASSERTION$open-sourceupdated 27 days ago
Slowing down
70/100
last commit 5 months ago
last release 5 months ago
releases 6
open issues 9

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up gemini-mcp-tool (mcp-stdio project) into my current project.
Found on https://claudeers.com/gemini-mcp-tool
Repo: https://github.com/jamubc/gemini-mcp-tool
Homepage/docs: https://jamubc.github.io/gemini-mcp-tool/
Detected install method: mcp-stdio → claude mcp add gemini-mcp-tool -- npx -y gemini-mcp-tool
Category: uncategorized. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
slowing; community-verified: false. Confirm the source before running anything.
// or install directly (mcp-stdio)
claude mcp add gemini-mcp-tool -- npx -y gemini-mcp-tool
// or clone
git clone https://github.com/jamubc/gemini-mcp-tool

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseNOASSERTION
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Gemini MCP Tool

📚 View Full Documentation - Search me!, Examples, FAQ, Troubleshooting, Best Practices

This is a simple Model Context Protocol (MCP) server that allows AI assistants to interact with the Gemini CLI. It enables the AI to leverage the power of Gemini's massive token window for large analysis, especially with large files and codebases using the @ syntax for direction.

  • Ask gemini natural questions, through claude or Brainstorm new ideas in a party of 3!
Gemini Tool MCP server

TLDR: + ()

Goal: Use Gemini's powerful analysis capabilities directly in Claude Code to save tokens and analyze large files.

Prerequisites

🚀 Important: Gemini CLI is retired. This tool now defaults to Antigravity CLI (`agy`)

On 2026-06-18, Google retired the Gemini CLI for free, Google AI Pro, and Google AI Ultra users (and individual Gemini Code Assist / GitHub-org users). Its successor is the Antigravity CLI (agy). See Google's announcement.

From 2026-06-18 this tool selects the agy backend automatically. If you are on an affected tier, just install agy:

curl -fsSL https://antigravity.google/cli/install.sh | bash   # macOS / Linux

Then run agy once to sign in. Nothing else to change.

Enterprise / Standard-license or paid-API-key user? Your Gemini CLI access is unaffected by the retirement. To keep using it, set one env var on the MCP server:

GEMINI_MCP_BACKEND=gemini
VariablePurpose
GEMINI_MCP_BACKENDgemini or agy/antigravity. Unset uses the date-aware default (agy from 2026-06-18).
AGY_CLI_PATHFull path to the agy binary if it isn't on the server's PATH.
GEMINI_MCP_TIMEOUTOverall CLI run timeout in minutes (default 45).

The agy backend is experimental: print mode is Gemini 3.5 Flash-only, replies come from agy's stdout (transcript recovery only as a fallback), and tool execution isn't sandboxed in -p. The tool emits a notice when a requested model/sandbox can't be honored, and surfaces agy's own errors (quota, auth) verbatim. Full analysis: docs/migration/antigravity-cli.md.

Before using this tool, ensure you have:

  1. Node.js (v16.0.0 or higher)
  2. Google Gemini CLI installed and configured

One-Line Setup

claude mcp add gemini-cli -- npx -y gemini-mcp-tool
For Windows users

Use -- y instead of -y:

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

Verify Installation

Type /mcp inside Claude Code to verify the gemini-cli MCP is active.


Alternative: Import from Claude Desktop

If you already have it configured in Claude Desktop:

  1. Add to your Claude Desktop config:
"gemini-cli": {
  "command": "npx",
  "args": ["-y", "gemini-mcp-tool"]
}
  1. Import to Claude Code:
claude mcp add-from-claude-desktop

Configuration

Register the MCP server with your MCP client:

Add this configuration to your Claude Desktop config file:

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

For Global Installation

If you installed globally, use this configuration instead:

{
  "mcpServers": {
    "gemini-cli": {
      "command": "gemini-mcp"
    }
  }
}

Configuration File Locations:

  • Claude Desktop:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/claude/claude_desktop_config.json

After updating the configuration, restart your terminal session.

Example Workflow

  • Natural language: "use gemini to explain index.html", "understand the massive project using gemini", "ask gemini to search for latest news"
  • Claude Code: Type /gemini-cli and commands will populate in Claude Code's interface.

Usage Examples

With File References (using @ syntax)

  • ask gemini to analyze @src/main.js and explain what it does
  • use gemini to summarize @. the current directory
  • analyze @package.json and tell me about dependencies

General Questions (without files)

  • ask gemini to search for the latest tech news
  • use gemini to explain div centering
  • ask gemini about best practices for React development related to @file_im_confused_about

Using Gemini CLI's Sandbox Mode (-s)

The sandbox mode allows you to safely test code changes, run scripts, or execute potentially risky operations in an isolated environment.

  • use gemini sandbox to create and run a Python script that processes data
  • ask gemini to safely test @script.py and explain what it does
  • use gemini sandbox to install numpy and create a data visualization
  • test this code safely: Create a script that makes HTTP requests to an API

Tools (for the AI)

These tools are designed to be used by the AI assistant.

  • ask-gemini: Asks Google Gemini for its perspective. Can be used for general questions or complex analysis of files.
    • prompt (required): The analysis request. Use the @ syntax to include file or directory references (e.g., @src/main.js explain this code) or ask general questions (e.g., Please use a web search to find the latest news stories).
    • model (optional): The Gemini model to use. Defaults to gemini-2.5-pro.
    • sandbox (optional): Set to true to run in sandbox mode for safe code execution.
  • sandbox-test: Safely executes code or commands in Gemini's sandbox environment. Always runs in sandbox mode.
    • prompt (required): Code testing request (e.g., Create and run a Python script that... or @script.py Run this safely).
    • model (optional): The Gemini model to use.
  • Ping: A simple test tool that echoes back a message.
  • Help: Shows the Gemini CLI help text.

Slash Commands (for the User)

You can use these commands directly in Claude Code's interface (compatibility with other clients has not been tested).

  • /analyze: Analyzes files or directories using Gemini, or asks general questions.
    • prompt (required): The analysis prompt. Use @ syntax to include files (e.g., /analyze prompt:@src/ summarize this directory) or ask general questions (e.g., /analyze prompt:Please use a web search to find the latest news stories).
  • /sandbox: Safely tests code or scripts in Gemini's sandbox environment.
    • prompt (required): Code testing request (e.g., /sandbox prompt:Create and run a Python script that processes CSV data or /sandbox prompt:@script.py Test this script safely).
  • /help: Displays the Gemini CLI help information.
  • /ping: Tests the connection to the server.
    • message (optional): A message to echo back.

Contributing

Contributions are welcome! Please see our Contributing Guidelines for details on how to submit pull requests, report issues, and contribute to the project.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Disclaimer: This is an unofficial, third-party tool and is not affiliated with, endorsed, or sponsored by Google.

// faq

What is gemini-mcp-tool?

MCP server that enables AI assistants to interact with Google Gemini CLI, leveraging Gemini's massive token window for large file analysis and codebase understanding. It is open-source on GitHub.

Is gemini-mcp-tool free to use?

gemini-mcp-tool is open-source under the NOASSERTION license, so it is free to use.

What category does gemini-mcp-tool belong to?

gemini-mcp-tool is listed under uncategorized in the Claudeers registry of Claude-compatible tools.

15 views
★ 2,297 stars
unclaimed
updated 27 days ago

// embed badge

gemini-mcp-tool on Claudeers
[![Claudeers](https://claudeers.com/api/badge/gemini-mcp-tool.svg)](https://claudeers.com/gemini-mcp-tool)

// retro hit counter

gemini-mcp-tool hit counter
[![Hits](https://claudeers.com/api/counter/gemini-mcp-tool.svg)](https://claudeers.com/gemini-mcp-tool)

// reviews

// guestbook

0/500

// related in Uncategorized / Others

🔓

Reverse engineer anything with agents, from app behavior down to native binaries.

// uncategorizedmorluto/⟨TypeScript⟩★ 468,336◷ MIT[ claude ]
🔓

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

// uncategorizedn8n-io/⟨TypeScript⟩★ 211,436◷ NOASSERTION[ claude ]
🔓

The agent engineering platform.

// uncategorizedlangchain-ai/⟨Python⟩★ 149,929◷ MIT[ claude ]
🔓

100+ AI Agent & RAG apps you can actually run — clone, customize, ship.

// uncategorizedShubhamsaboo/⟨Python⟩★ 144,747◷ Apache-2.0[ claude ]

// built by

→ see how gemini-mcp-tool connects across the ecosystem