Gemini Image
Connects Claude to Google's Gemini image generation API with two tools: generate_image for text-to-image, multi-turn editing with reference images, and iterative refinement via session IDs, plus process_image for local operations like cropping, background removal, chroma keying, and format conversion. Built on Gemini's current generateContent API rather than the deprecated Imagen service. Includes built-in cost tracking per request and session, configurable rate limits to prevent runaway agent spending, and auto-discovery of available models from your API key. Saves outputs with auto-versioning, maintains a generation manifest in JSONL, and supports aspect ratios from 1:1 to 21:9 at 1K/2K/4K resolutions. Good fit if you need programmatic image generation with cost controls or want to batch process images locally without hitting APIs.
- GitHub stars
- 2
- tools
- 2
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Sep 16, 2026
Tools
2 toolsPublic tool metadata for what this MCP can expose to an agent.
generate_imageAI-powered image generation and editing using Gemini's native image generation (Nano Banana models).
AI-powered image generation and editing using Gemini's native image generation (Nano Banana models).
No parameter schema in public metadata yet.
process_imageLocal image processing via sharp: crop, resize, background removal, trim and format conversion, free with no API calls.
Local image processing via sharp: crop, resize, background removal, trim and format conversion, free with no API calls.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GEMINI_API_KEY*secretGoogle Gemini API key from https://aistudio.google.com/apikey
Readme
gemini-image-mcp
A simple, focused MCP server for Google Gemini's native image generation — the "Nano Banana" models. Generate, edit, and locally process images from Claude Code, Claude Desktop, or any stdio-based MCP client. Two tools, no bloat.
Built for agents: a single call returns a saved image — or, with one-call background removal, a ready-to-use transparent PNG — without streaming image data through your agent's context. Uses Gemini's generateContent API (not the deprecated Imagen API).
Install
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
Features
Details
- Repository
- github.com/jimothysnicket/gemini-image-mcp
- Category
- AI & LLM Tools
- Package
@jimothy-snicket/gemini-image-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related AI & LLM Tools MCP servers
View all
Agentic Platformandysalvo/agentic-platformFree MCP tools: the only MCP linter, health checks, cost estimation, and trust evaluation.1stars
agent-tools (x402 + MCP + A2A directory)agenttools-cloud/agenttoolscollectionDiscover x402 services, MCP servers and A2A agents by intent — agent-tools.cloud directory.0stars
Claude Memory Managernyxtoolsdev/claude-memory-managerCross-session memory for Claude Code — context capture, semantic search, recall1stars
Cozo Memorytobs-code/cozo-memoryLocal-first memory system for AI agents with hybrid search and graph reasoning1stars
TeamMemoryysydhc/team_memoryTeam experience database - let AI accumulate, retrieve and apply team knowledge across chats.1stars