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.

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

- Gemini CLIinstalled and configured (optional with --allow-npx flag)

claude mcp add -s project gemini-cli -- npx mcp-gemini-cli --allow-npx

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

git clone https://github.com/choplin/mcp-gemini-cli cd mcp-gemini-cli bun install

{ "mcpServers": { "mcp-gemini-cli": { "command": "bun", "args": ["run", "/path/to/mcp-gemini-cli/index.ts"] } } }

Performs a Google search using Gemini CLI.

- 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")

- 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")

Analyze files using Gemini's multimodal capabilities.

- Images: PNG, JPG, JPEG, GIF, WEBP, SVG, BMP
- Text: TXT, MD, TEXT
- Documents: PDF

- 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")

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"

// Simple search googleSearch({ query: "latest AI news" }); // Search with limit googleSearch({ query: "TypeScript best practices", limit: 5, });

// Simple chat chat({ prompt: "Explain quantum computing in simple terms" }); // Using a different model chat({ prompt: "Write a haiku about programming", model: "gemini-2.5-flash", });

// Analyze an image analyzeFile({ filePath: "/path/to/image.png", prompt: "What objects are in this image?" }); // Analyze a PDF analyzeFile({ filePath: "/path/to/document.pdf", prompt: "Summarize the key points in this document" }); // General analysis without specific instructions analyzeFile({ filePath: "/path/to/file.jpg" });

Note: Development requiresBunruntime.

# Development build bun run build # Production build (minified) bun run build:prod

# Lint code bun run lint # Format code bun run format

- Model Context Protocol (MCP)
- Gemini CLI
- Bun Runtime

Interact with Infactory APIs using Claude and other large language models.