Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a claude-code
Open on GitHub

What 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:3 and save it as output.png.
  • Edit photo.jpg by adding a sunset sky, then save the result as edited.jpg.
  • Use mask.png with portrait.jpg to change the shirt to blue with the pro model.

How to install nanobanana-mcp-image-generation

1Skills CLI (Vercel)

npx skills add reason-machines/mcp-skills --skill nanobanana-mcp-image-generation -a claude-code

2Manually: put the files in place

~/.claude/skills/nanobanana-mcp-image-generation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/nanobanana-mcp-image-generation/

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.

Similar skills

All skills for AI and ML →

From the same set98

The whole set →
linux-mcp-server-administration The linux-mcp-server-administration skill gives Claude Code read-only Linux diagnostics through MCP and SSH. Use it to inspect RHEL-based hosts, services, logs, processes, networking, and storage. CX Codex +1 178installs mcp-server-spec-driven-development The mcp-server-spec-driven-development skill guides a project from EARS requirements to a design document and generated code. Use it when you want those steps to build on one another. CX Codex +1 175installs mcp-code-execution-mode mcp-code-execution-mode executes Python inside rootless containers and routes calls to MCP servers to keep token consumption minimal. CX Codex +1 174installs mcp-server-code-execution-mode mcp-server-code-execution-mode executes Python in rootless Podman or Docker containers and proxies MCP tools through a single entry point, cutting context from 30,000 to 200 tokens. CX Codex +1 173installs mcp-server-bash-sdk mcp-server-bash-sdk guides you in building zero-runtime Model Context Protocol servers using pure Bash and jq instead of heavy runtimes. CX Codex +1 171installs codex-mcp-server-integration codex-mcp-server-integration — a skill that bridges OpenAI Codex CLI to Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode via MCP. Brings code analysis, generation, branch review, and web search into the editor. CX Codex +1 171installs remote-mcp-server-with-auth remote-mcp-server-with-auth is a Claude Code skill for building and deploying a Cloudflare Workers MCP server with GitHub OAuth and PostgreSQL. It supports role-based permissions. CX Codex +1 168installs postman-mcp-server Hooks your coding agent up to Postman over MCP: workspaces, collections, environments, request runs and client code generation. CX Codex +1 168installs

Project sponsors

Companies that keep this analytics open