Gemini Tool MCP Server
Gemini CLI and Antigravity CLI integration for large-scale AI analysis tasks.
Data last scanned today · Reviewed today
Overview
This TypeScript-based MCP server bridges AI assistants with the Gemini CLI or its successor, the Antigravity CLI (agy). It is designed to leverage expansive token windows to process large codebases and complex files directly through the MCP interface. The server automatically manages backend selection based on current deprecation schedules, favoring the Antigravity CLI by default. Users have the flexibility to override the backend via environment variables for enterprise compatibility.
Our verdict
This server holds a high-risk security score of 48/100, largely because it is a community-maintained project that has not undergone an independent editorial security review. While it lacks explicitly dangerous tools, its reliance on community maintenance and unverified authentication methods makes it best suited for users who can independently audit the code and manage their own API configurations.
- Integrated support for Antigravity CLI
- Streamlined processing for large file analysis
- Active development with commits from three days ago
- Limited supply-chain surface with only six direct dependencies
- High security risk level of 48/100
- Lacks independent editorial security review
- Authentication and read-only modes remain unverified
- NOASSERTION license status
Setup
{
"mcpServers": {
"gemini-mcp-tool": {
"args": [
"-y",
"gemini-mcp-tool"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| ask-gemini | Asks Google Gemini for its perspective. | medium |
| sandbox-test | Safely executes code or commands in Gemini's sandbox environment. | high |
| Ping | A simple test tool that echoes back a message. | low |
| Help | Shows the Gemini CLI help text. | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›Does this tool still support the original Gemini CLI?
Yes, if you are an Enterprise, Standard-license, or paid-API-key user, you can keep using the Gemini CLI by setting the GEMINI_MCP_BACKEND environment variable to 'gemini'.
›What is the default backend if I am not a paid user?
As of June 18, 2026, the tool defaults to the Antigravity CLI (agy) for free and individual Pro/Ultra users following the retirement of the Gemini CLI.
›Can I specify a custom path for the Antigravity CLI binary?
Yes, you can use the AGY_CLI_PATH environment variable to provide the full path to the agy binary if it is not located on the server's PATH.
›How can I adjust the timeout for CLI operations?
You can configure the GEMINI_MCP_TIMEOUT environment variable to set the overall CLI run timeout in minutes, which defaults to 45 minutes.
›What are the core software requirements to run this server?
You need Node.js version 16.0.0 or higher and either the Gemini CLI or Antigravity CLI installed and configured on your system.
Alternatives
Changelog
- Securityv1.1.8: Antigravity CLI (agy) backend
2026-06-18
- Fixv1.1.7
2026-06-01
- Securityv1.2.0-beta.1 — beta
2026-05-30
- Securityv1.1.6 — security patch (CVE-2026-0755)
2026-05-30
- Securityv1.1.5
2026-05-27
- Improvedv1.1.2
2025-07-13
Badge
Maintain this server? Add the live badge to your README.