Gemini MCP Tool
An MCP server that lets the agent call Gemini through its CLI to analyze large files and whole codebases
- 2,297 ★ on the repository
- Last commit
Extended access
Why this level
- Runs an external CLI as a subprocess and sends file contents to a Google service
- Can execute code in Gemini's sandbox on request
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/gemini-mcp-toolDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs an external CLI as a subprocess and sends file contents to a Google service
- Can execute code in Gemini's sandbox on request
This is third-party code. Review the repository files before installing.
What it does
The server links a coding agent to the Gemini command line and lets it hand Gemini heavy tasks, using its large context window. Through the @ syntax a request can include files and directories for Gemini to analyze and return an explanation or summary, sparing the main agent's context. It offers a tool for asking Gemini questions, a joint brainstorm mode and a sandbox for running code safely. After Google retired free access to the Gemini CLI, the server defaults to its successor, the Antigravity CLI, while paid and enterprise tiers switch the old backend back on via an environment variable. Authentication happens in the external CLI; the server itself stores no keys.
Who it is for. For developers who work in a coding agent and want to offload analysis of large files and repositories to Gemini.
Good fit when
- You need to analyze a large file or a whole repository that does not fit the main agent's context
- You want a second opinion from Gemini right inside your coding agent
- You need to run code or a script safely in Gemini's sandbox
Not a fit when
- You do not have a Gemini CLI or Antigravity CLI installed and configured
- The task is small and fits the main agent's context without calling out
Example request
Ask gemini to analyze @src and explain how the main data flow is organizedMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
GEMINI_MCP_BACKEND- Backend choice: gemini or agy. Unset uses the date-aware default, which is agy from 2026-06-18.
AGY_CLI_PATH- Full path to the agy binary if it is not on the server's PATH.
Limitations
It needs Node.js 16 or newer and an installed Gemini CLI or Antigravity CLI, with sign-in done in the CLI itself. Google retired free access to the Gemini CLI, so the Antigravity CLI is used by default, and its backend is marked experimental with limits on models and sandbox. Google's Gemini and Antigravity services are unavailable from Russia without a VPN. This is an unofficial third-party tool and is not affiliated with Google.
How to disable. Remove the gemini-cli entry from your MCP client config. In Claude Code use claude mcp remove gemini-cli.
FAQ
Do I need a separate key in the server config?
No, the server stores no keys. Authentication and access are set up in the Gemini CLI or Antigravity CLI itself, where you sign in once.
What about the free Gemini CLI?
Google retired its free access, so the server defaults to the Antigravity CLI. Paid and enterprise tiers can switch the old backend back on with an environment variable.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server that lets an agent read files, search code and run commands in a workspace
A Gemini CLI extension on the PDCA cycle: 21 agents, 35 skills and 24 commands for planning, design, build and analysis
MCP DevTools replaces a dozen MCP servers with one Go binary: search, page fetch, package documentation and GitHub.
An MCP server that indexes code with tree-sitter and returns individual functions and classes to the agent instead of whole files
The CodeAlive MCP server: the agent searches large codebases by meaning and exactly and follows call relations without a full read
A git MCP server with 28 tools: an agent clones, commits, branches, merges, rebases and manages worktrees in local repositories.
README in short
The README describes an MCP server that links an AI assistant to the Gemini command line to use its large context window for analyzing big files and codebases. Files and directories are included in a request via the @ syntax, and there are tools for questions, brainstorming and a sandbox for safe code execution. It also covers the move from the retired free Gemini CLI to the Antigravity CLI and the environment variables that control backend choice, binary path and timeout. Installation is a single npx command or an entry added to the MCP client config. The tool is unofficial and not affiliated with Google, under the MIT license.