jamubc/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!
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:
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:
| Variable | Purpose |
| --- | --- |
| GEMINI_MCP_BACKEND | gemini or agy/antigravity. Unset uses the date-aware default (agy from 2026-06-18). |
| AGY_CLI_PATH | Full path to the agy binary if it isn't on the server's PATH. |
| GEMINI_MCP_TIMEOUT | Overall 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
For Windows users
Use -- y instead of -y:
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:
2. Import to Claude Code:
Configuration
Register the MCP server with your MCP client:
For NPX Usage (Recommended)
Add this configuration to your Claude Desktop config file:
For Global Installation
If you installed globally, use this configuration instead:
**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