choplin/mcp-gemini-cli

A simple MCP server wrapper for Google's Gemini CLI that enables AI assistants to use Gemini's capabilities through the Model Context Protocol.
What it does
This server exposes three tools that interact with Gemini CLI:
- googleSearch: Asks Gemini to perform a Google search using your query
- chat: Sends prompts directly to Gemini for general conversations
- analyzeFile: Analyzes files (images, PDFs, text) using Gemini's multimodal capabilities
Prerequisites
- Gemini CLI installed and configured (optional with --allow-npx flag)
🚀 Quick Start with Claude Code
1. Add the MCP server
Or configure your MCP client with the settings shown in the Installation Options section below.
2. Try it out
Example prompts:
- **Search**: "Search for the latest TypeScript 5.0 features using Google"
- **Chat**: "Ask Gemini to explain the difference between async/await and promises in JavaScript"
- **File Analysis**: "Ask Gemini to analyze the image at /path/to/screenshot.png"
🔧 Installation Options
Using npx with --allow-npx flag
Local Development
1. Clone and install:
1. Add to Claude Desktop config:
🛠️ Available Tools
1. googleSearch
Performs a Google search using Gemini CLI.
**Parameters:**
- query (required): The search query
- limit (optional): Maximum number of results
- sandbox (optional): Run in sandbox mode
- yolo (optional): Skip confirmations
- model (optional): Gemini model to use (default: "gemini-2.5-pro")
2. chat
Have a conversation with Gemini.
**Parameters:**
- prompt (required): The conversation prompt
- sandbox (optional): Run in sandbox mode
- yolo (optional): Skip confirmations
- model (optional): Gemini model to use (default: "gemini-2.5-pro")
3. analyzeFile
Analyze files using Gemini's multimodal capabilities.
**Supported file types:**
- **Images**: PNG, JPG, JPEG, GIF, WEBP, SVG, BMP
- **Text**: TXT, MD, TEXT
- **Documents**: PDF
**Parameters:**
- filePath (required): The absolute path to the file to analyze
- prompt (optional): Additional instructions for analyzing the file
- sandbox (optional): Run in sandbox mode
- yolo (optional): Skip confirmations
- model (optional): Gemini model to use (default: "gemini-2.5-pro")
💡 Example Prompts
Try these prompts to see mcp-gemini-cli in action:
- **Search**: "Search for the latest TypeScript 5.0 features using Google"
- **Chat**: "Ask Gemini to explain the difference between async/await and promises in JavaScript"
- **File Analysis**: "Ask Gemini to describe what's in this image: /Users/me/Desktop/screenshot.png"
🛠️ Example Usage
googleSearch
chat
analyzeFile
📝 Development
> **Note**: Development requires Bun runtime.