nanobanana-mcp-image-generation — Claude Code skill: install
The nanobanana-mcp-image-generation skill connects an agent to Gemini image generation and editing with model selection, 4K output, aspect ratios, and templates. Use it for visual assets from a coding workspace.
no license 172 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a claude-codeWhat nanobanana-mcp-image-generation does
The skill documents an MCP server for creating images from text and changing existing files. It supports automatic routing across the nb2, pro, and flash tiers, with controls for 4k or 1k output, aspect ratios such as 1:1 and 16:9, variation count, negative prompts, and output paths. Templates cover photography and design, while image files can be sent through the Gemini Files API.
A Google Gemini API key is required, exposed through GEMINI_API_KEY. The MCP setup runs uvx with nanobanana-mcp-server@latest; Google Cloud deployments can use vertex_ai, GCP_PROJECT_ID, and GCP_REGION. Without GEMINI_API_KEY, Gemini generation will not run.
The documented tools cover generation, masked edits, and uploading a reference image. Choose pro for demanding compositions with thinking_level, flash for quick drafts, or pass a seed when you need a repeatable result.
What it helps with
- generate an image from a text prompt
- set an image ratio and output resolution
- produce several variations of one concept
- edit an existing image with a prompt
- upload a reference file for generation
Example prompts for the agent
- Generate a coffee mug product image in
4:3and save it asoutput.png. - Edit
photo.jpgby adding a sunset sky, then save the result asedited.jpg. - Use
mask.pngwithportrait.jpgto change the shirt to blue with thepromodel.
How to install nanobanana-mcp-image-generation
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a claude-code2Manually: put the files in place
~/.claude/skills/nanobanana-mcp-image-generation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/nanobanana-mcp-image-generation/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a codex2Manually: put the files in place
.agents/skills/nanobanana-mcp-image-generation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a cursor2Manually: put the files in place
.cursor/skills/nanobanana-mcp-image-generation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/nanobanana-mcp-image-generation2Manually: put the files in place
.github/skills/nanobanana-mcp-image-generation/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/nanobanana-mcp-image-generationManually: put the files in place
.devin/skills/nanobanana-mcp-image-generation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about nanobanana-mcp-image-generation
How do I install nanobanana-mcp-image-generation in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a claude-code, then use ~/.claude/skills/nanobanana-mcp-image-generation/SKILL.md.
What does nanobanana-mcp-image-generation do?
The skill guides an agent in using a Gemini MCP server for image generation and editing. It covers model tiers, 4K output, aspect ratios, templates, and file handling.
What is required to use Gemini with this skill?
You need a Google Gemini API key exposed as GEMINI_API_KEY. Vertex AI use also requires enabling aiplatform.googleapis.com and granting roles/aiplatform.user.