gemini-image-mcp

MCP server for Google Gemini image generation, editing, and processing. Two tools, no bloat.

Built on Gemini's native image generation API (generateContent), not the deprecated Imagen API. If you're migrating from Imagen (shutting down June 2026), this is what you move to — multi-turn editing, reference images, and all the features Imagen didn't have.

npm install -g @jimothy-snicket/gemini-image-mcp

Or use directly with npx:

npx -y @jimothy-snicket/gemini-image-mcp

Claude Code (one command):

claude mcp add gemini-image -- npx -y @jimothy-snicket/gemini-image-mcp

Requires a GEMINI_API_KEY environment variable — see Setup for details.

Set up a config file (optional):

npx @jimothy-snicket/gemini-image-mcp --init

Creates ~/.gemini-image-mcp.json with commented defaults. For project-specific overrides:

npx @jimothy-snicket/gemini-image-mcp --init --local

• Text-to-image — describe what you want, get an image
• Image editing — provide reference images and an editing instruction
• Multi-turn sessions — iteratively refine images with conversation history
• Multi-image input — up to 14 reference images on gemini-3-pro
• Cost reporting — every response includes token counts, estimated USD cost, and session totals
• Rate limiting — configurable per-hour caps on requests and cost to prevent runaway agents
• Auto model discovery — detects available image models from your API key at startup
• Seed — reproducible generation with integer seeds
• Google Search grounding — real-world accuracy on gemini-3.1-flash

• Crop — pixel-exact, aspect ratio (center), or focal point (attention/entropy)
• Resize — to width, height, or both (maintains aspect ratio)
• Background removal — threshold-based (white backgrounds) or chroma