gemini-mcp-tool MCP工具

Prerequisites

<details> <summary>🚀 <strong>Important: Gemini CLI is retired. This tool now defaults to Antigravity CLI (agy)</strong></summary>

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

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.

</details>

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

<details> <summary>For Windows users</summary>

Use -- y instead of -y:

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

</details>

Verify Installation

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

---

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.

For NPX Usage (Recommended)

Add this configuration to your Claude Desktop config file:

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

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

Configuration

Register the MCP server with your MCP client:

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

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

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