AI Plugin Index
gemini-mcp
CommunityMCP server by chrischall · updated · ★ 0 · 522 downloads a week
Generate and edit images with Google Gemini (Nano Banana / Nano Banana Pro) image models. gemini-mcp is a community project by chrischall, not verified by a company domain.
Last commit 4 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
GEMINI_Environment variable, secret | Optional | Your Google Gemini API key (aistudio.google.com/apikey) |
GEMINI_Environment variable | Optional | Override the default image model (default: gemini-nano-banana-2.1) |
GEMINI_Environment variable | Optional | Default directory for generated images (default: ~/Downloads/gemini-mcp). When set, a per-call output_dir must be inside it. |
GEMINI_Environment variable | Optional | Directory to resolve bare input-image filenames against |
GEMINI_Environment variable | Optional | Restrict local-file uploads to the Gemini Files API to these directories (path.delimiter-separated; unset = unrestricted) |
GEMINI_Environment variable | Optional | Restrict 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/u |
GEMINI_Environment variable | Optional | Upstream request timeout in ms (default: 60000, or 120000 for image_size: "4K"); each generation tool also takes a per-call timeout_ms |
GEMINI_Environment variable | Optional | Progress-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 generations |
GEMINI_Environment variable | Optional | How long to wait out interactions-store lag when a chained call 404s (default: 120000; 0 disables retrying) |
GEMINI_Environment variable | Optional | When set, emit heartbeat diagnostics to stderr. Off by default. |
GEMINI_Environment variable | Optional | Override/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). |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install gemini-mcp
Built from the published package, never by AIclaude mcp add gemini-mcp -- npx -y @chrischall/gemini-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"gemini-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"gemini-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"gemini-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add gemini-mcp -- npx -y @chrischall/gemini-mcp{
"mcpServers": {
"gemini-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/gemini-mcp"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add gemini-mcp npx -y @chrischall/gemini-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the gemini-mcp block.
Weekly newsletter
Like gemini-mcp? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to gemini-mcp
All alternatives →
Natural voice conversations for AI assistants - STT/TTS via MCP
Transcribe local audio with FunASR and SenseVoice using private, on-device inference.
Identify and remove AI watermarks and provenance metadata from your own images and video.
MCP App Server demonstrating video resources served as base64 blobs
MCP App Server for rendering and playing sheet music from ABC notation
Trim, convert, resize, compress, and remix audio and video.
gemini-mcp: common questions
How do I install gemini-mcp?
In Claude Code run claude mcp add gemini-mcp -- npx -y @chrischall/gemini-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is gemini-mcp the official server?
gemini-mcp is a community project by chrischall, not verified by a company domain.
Is gemini-mcp free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is gemini-mcp safe to use?
It scores 79 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to gemini-mcp?
Similar MCP servers: voicemode, FunASR, Remove AI Watermarks, Server Video Resource.
Does gemini-mcp work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.