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
G
Gemini MCP Tool
Community
Use Gemini in Claude to analyze large files and codebases.
GitHub source repository ↗
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.
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.
Tools
ask-gemini
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
Tests code or commands in Gemini sandbox mode; it always runs with sandbox enabled.
Ping
Echoes a message to test the connection.
Help
Displays Gemini CLI help text.
Setup
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"]}}}
Fit and risk
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
Troubleshooting
- Run `/mcp` in Claude Code to confirm the server is active
- Verify that Node.js is version 16 or later
- Verify that Gemini CLI or agy is installed, executable, and signed in
- Set `AGY_CLI_PATH` if agy is not on PATH
- Check that `GEMINI_MCP_BACKEND` is `gemini`, `agy`, or `antigravity`
- Check `GEMINI_MCP_TIMEOUT` when needed; the default timeout is 45 minutes
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 DesktopFull support
Claude CodeFull support