gemini-mcp-tool

# Gemini MCP Tool <div align="center"> [](https://github.com/jamubc/gemini-mcp-tool/releases) [](https://www.npmjs.com/package/gemini-mcp-tool) [](https://www.npmjs.com/package/gemini-mcp-tool) [](https://opensource.org/licenses/MIT) [](https://github.com/jamubc/gemini-mcp-tool) </div> > 📚 **[View Full Documentation](https://jamubc.github.io/gemini-mcp-tool/)** - 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](https://github.com/google-gemini/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! <a href="https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool/badge" alt="Gemini Tool MCP server" /> </a> ## TLDR: [](#) + [](#) **Goal**: Use Gemini's powerful analysis capabilities directly in Claude Code to save tokens and analyze large files. ## Prerequisites Before using this tool, ensure you have: 1. **[Node.js](https://nodejs.org/)** (v16.0.0 or higher) 2. **[Google Gemini CLI](https://github.com/google-gemini/gemini-cli)** installed and configured ### One-Line Setup ```bash claude mcp add gemini-cli -- npx -y gemini-mcp-tool ``` ### 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: ```json "gemini-cli": { "command": "npx", "args": ["-y", "gemini-mcp-tool"] } ``` 2. Import to Claude Code: ```bash claude mcp add-from-claude-desktop ``` ## Configuration Register the MCP server with your MCP client: ### For NPX Usage (Recommended) Add this configuration to your Claude Desktop config file: ```json { "mcpServers": { "gemini-cli": { "command": "npx", "args": ["-y", "gemini-mcp-tool"] } } } ``` ### For Global Installation If you installed globally, use this configuration instead: ```json { "mcpServers": { "gemini-cli": { "command": "gemini-mcp" } } } ``` **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` - `use gemini to summarize @. the current directory` - `analyze @package.json and tell me about dependencies` ### General Questions (without files) - `ask gemini to search for the latest tech news` - `use gemini to explain div centering` - `ask gemini about best practices for React development related to @file_im_confused_about` ### Using Gemini CLI's Sandbox Mode (-s) The sandbox mode allows you to safely test code changes, run scripts, or execute potentially risky operations in an isolated environment. - `use gemini sandbox to create and run a Python script that processes data` - `ask gemini to safely test @script.py and explain what it does` - `use gemini sandbox to install numpy and create a data visualization` - `test this code safely: Create a script that makes HTTP requests to an API` ### Tools (for the AI) These tools are designed to be used by the AI assistant. - **`ask-gemini`**: Asks Google Gemini for its perspective. Can be used for general questions or complex analysis of files. - **`prompt`** (required): The analysis request. Use the `@` syntax to include file or directory references (e.g., `@src/main.js explain this code`) or ask general questions (e.g., `Please use a web search to find the latest news stories`). - **`model`** (optional): The Gemini model to use. Defaults to `gemini-2.5-pro`. - **`sandbox`** (optional): S