Gemini MCP Tool Setup for Claude Code, Cursor and Other Apps
Lets Claude and other assistants pass big files and whole folders to Google's Gemini CLI and bring back its answer.
This community server runs on your computer and forwards your questions to the Gemini command-line tool you already have installed. Point it at files with the @ syntax, and Gemini reads them with its large context window, so your assistant spends fewer of its own tokens. It needs the Gemini CLI, or its successor the Antigravity CLI (agy), installed and signed in first. It is not made by Google. Your prompt and the files you reference go to Google through that CLI.
Good for
- Claude Code users who want Gemini to read a large codebase or file for them
- Developers who want a second model's opinion on a design or a diff
- Anyone already signed in to the Gemini or Antigravity CLI
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install gemini-mcp-tool
Claude Code
- 1
Copy this prompt.
Add the gemini-mcp-tool server to Claude Code. Run this command: claude mcp add gemini-tool -- npx -y gemini-mcp-tool Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js, Gemini CLI or Antigravity CLI (agy), signed in.
Install and sign in to the Gemini CLI, or the Antigravity CLI (agy), first. The server calls whichever one is installed and stores no key itself. The README uses the server name gemini-cli; any name works.
Built from the package data we hold. Not yet tested by us.
Tools
Asks Gemini a question about your files or any topic
Sends your question to Gemini and returns its answer. Put @ in front of a file or folder to have Gemini read it. You can pick a model, turn on sandbox mode for running code, or ask for edits in a structured format your assistant can apply.
Try: “Ask Gemini to explain what @src/index.ts does and list anything risky.”
Runs code ·
ask-geminiGets a batch of ideas from Gemini using a chosen method
Wraps your challenge in a brainstorming method such as SCAMPER or design thinking, then asks Gemini for about a dozen ideas. You can add a field, limits and background, and ask for a feasibility check on each idea.
Try: “Brainstorm 10 ways to cut onboarding time for my app, with a budget under $5k.”
Runs code ·
brainstormUsed by the assistant behind the scenes
Fetches the next part of a long edit suggestion
When change-mode edits are too long for one reply, this retrieves the next saved piece using the key from the first reply. Your assistant calls it for you.
Try: “Get the next chunk of the edit suggestions Gemini gave me.”
Read ·
fetch-chunkChecks that the server is running by echoing a message
A connection test. It sends your message to the system echo command and returns it, so you can confirm the server answers.
Try: “Ping the Gemini tool and say hello.”
Runs code ·
pingShows the Gemini CLI's own help text
Prints the help screen of the Gemini command-line tool. Useful to see which options your installed version supports.
Try: “Show me the Gemini CLI help text.”
Runs code ·
Help
Read from the source code
Permissions
high risk · 3 things to watch · 1 advisory
High risk
Your prompts and any files you reference with @ are sent to Google through the Gemini or Antigravity CLI, and Gemini can be asked to write and run scripts on your machine. Use it only on files you are happy to share, and leave sandbox mode on for anything that runs code.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Gemini can run scripts on your machine
The README shows prompts that create and run code through Gemini. The sandbox flag is off by default, and with the Antigravity backend the project says it does not isolate tool execution. Only use it in folders you can afford to change. github.com
Referenced files are sent to Google
Everything you point at with @ is read and sent to Google's model through the CLI. Keep secrets and private code out of the prompt. github.com
Default backend changed on 2026-06-18
The tool now picks the experimental Antigravity CLI unless you set GEMINI_MCP_BACKEND to gemini. In that mode the model option is ignored and replies are Flash-only. github.com
Security advisories
Technical details
| Turning on read-only | No read-only mode is documented. The sandbox option isolates code the Gemini CLI runs, but the Antigravity (agy) backend does not isolate tool execution. |
|---|---|
| Talks to | Google, through the Gemini or Antigravity CLI you have installed |
| Sign-in and keys | The server stores no credentials. Sign-in lives in the Gemini CLI or Antigravity CLI. |
Questions
Is the Gemini MCP Tool official?
No. It is a community project by jamubc, and the README says it is not affiliated with or endorsed by Google.
Do I need a Gemini API key?
No key goes into the server. You need the Gemini CLI, or the Antigravity CLI (agy), installed and signed in. Enterprise or paid API key users can keep the Gemini CLI by setting one environment variable.
What happened to the Gemini CLI?
Google retired it on 2026-06-18 for free, Google AI Pro and Ultra users. This tool then switches to the Antigravity CLI on its own, and the README calls that backend experimental.
Does it work with Claude Desktop and Cursor?
The README gives setup for Claude Code and Claude Desktop, and the install box has the config for other apps. The README says other clients have not been tested for its slash commands.
Can it run read-only?
No read-only mode is documented. Sandbox mode limits where Gemini runs code, but it is not a read-only switch.
Is my code sent to Google?
Yes. Anything you reference with @ is read by the Gemini CLI and sent to Google's model.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
gemini-mcp-tool- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 1.1.8
- License
- MIT
- Last commit
- Jul 21, 2026
- Open issues
- 9
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- github.com · github.com