Gemini MCP
Generate and edit images with Google Gemini (Nano Banana / Nano Banana Pro) image models.
- Pricing
- Open source
- Runs
- Locally
- Version
- 2.5.1
- Listing updated
- 5 days ago
About Gemini MCP
Gemini MCP is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add gemini-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y @chrischall/gemini-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"gemini-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gemini-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gemini-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gemini-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gemini-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GEMINI_API_KEYYour Google Gemini API key (aistudio.google.com/apikey)GEMINI_IMAGE_MODELOverride the default image model (default: gemini-nano-banana-2.1)GEMINI_OUTPUT_DIRDefault directory for generated images (default: ~/Downloads/gemini-mcp). When set, a per-call output_dir must be inside it.GEMINI_INPUT_DIRDirectory to resolve bare input-image filenames againstGEMINI_UPLOAD_DIRRestrict local-file uploads to the Gemini Files API to these directories (path.delimiter-separated; unset = unrestricted)GEMINI_REFERENCE_DIRRestrict local reference images (images / image paths sent to Gemini) to these directories (path.delimiter-separated), plus GEMINI_OUTPUT_DIR. Unset: GEMINI_UPLOAD_DIR applies; if that is unset too, unrestricted locally, and $MCP_DATA_DIR/uploads when MCP_DATA_DIR is set (hosted)GEMINI_TIMEOUT_MSUpstream request timeout in ms (default: 60000, or 120000 for image_size: "4K"); each generation tool also takes a per-call timeout_msGEMINI_HEARTBEAT_MSProgress-notification cadence in ms while a generation runs (default: 10000; 0 disables) — keeps MCP hosts that reset their timeout on progress from timing out long generationsGEMINI_CHAIN_RETRY_MSHow long to wait out interactions-store lag when a chained call 404s (default: 120000; 0 disables retrying)GEMINI_DEBUGWhen set, emit heartbeat diagnostics to stderr. Off by default.GEMINI_RATE_CARDOverride/extend the shipped USD-per-1M-token rates used by gemini_token_usage's cost estimate, e.g. {"gemini-3-pro-image":{"input":2,"text_output":12,"image_output":120}}. Malformed JSON is ignored (a bad card must not fail generations).
Pricing
Open source
Gemini MCP FAQ
Is Gemini MCP free?
Yes. Gemini MCP is open source, so you can use and self-host it for free.
How do I add Gemini MCP to Claude Code?
Run this command in your terminal: claude mcp add gemini-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y @chrischall/gemini-mcp
What are the best alternatives to Gemini MCP?
The closest alternatives to Gemini MCP are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.
Alternatives to Gemini MCP

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 86.1K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 7.8K GitHub stars
- Design and media

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
- Remote
- Freemium
- Design and media