Gemini MCP Server is a community-built Model Context Protocol bridge that connects AI assistants to the Google Gemini CLI, enabling analysis of large files and codebases using Gemini's extensive token context window. Key features include: - Integration with Google Gemini CLI to extend AI assistant capabilities - Support for massive file analysis that exceeds standard context limits - `@` syntax for directing queries to specific files, directories, or code sections - Token-efficient processing of large codebases and documents - Natural language interaction with Gemini directly through Claude Code and other MCP-compatible clients

Gemini MCP Tool

[](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)

> 📚 View Full Documentation - 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. 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.

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 (v16.0.0 or higher) 2. Google Gemini CLI installed and configured

One-Line Setup

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:

"gemini-cli": {
  "command": "npx",
  "args": ["-y", "gemini-mcp-tool"]
}

2. Import to Claude Code:

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:

{
  "mcpServers": {
    "gemini-cli": {
      "command": "npx",
      "args": ["-y", "gemini-mcp-tool"]
    }
  }
}

For Global Installation

If you installed globally, use this configuration instead:

{
  "mcpServers": {
    "gemini-cli": {
      "command": "gemini-mcp"
    }
  }
}

Configuration File Locations:

After updating the configuration, restart your terminal session.

Example Workflow

Usage Examples

With File References (using @ syntax)

General Questions (without files)

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.

Tools (for the AI)

These tools are designed to be used by the AI assistant.