English Français العربية

io.github.fjacquet/nano-banana-mcp

Official registry Media and design

AI image generation and editing with Google Gemini: Nano Banana 2.1, Pro and Lite models

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @fjacquet/nano-banana-mcp
Claude Code 
claude mcp add nano-banana-mcp -e 'GEMINI_API_KEY=<your gemini_api_key>' -- npx -y @fjacquet/nano-banana-mcp@3.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "nano-banana-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@fjacquet/nano-banana-mcp@3.2.1"
            ],
            "env": {
                "GEMINI_API_KEY": "<your gemini_api_key>"
            }
        }
    }
}

Environment variables

  • GEMINI_API_KEY secret Gemini API key from Google AI Studio. Optional: it can also be set later with the configure_gemini_token tool.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Nano-Banana MCP Server
  2. Quick Start
  3. Tools
  4. Development
  5. License

Nano-Banana MCP Server

An MCP server for AI image generation and editing using Google Gemini. Works with Claude Code, Cursor, and other MCP clients.

Models supported:

Brand nameModel IDNotes
Nano Banana 2.1gemini-nano-banana-2.1Default — pro quality at Flash speed
Nano Banana Progemini-3-pro-imageHighest quality, advanced reasoning
Nano Banana 2gemini-3.1-flash-imagePrevious default
Nano Banana 2 Litegemini-3.1-flash-lite-imageFastest and cheapest — 1K output only
Nano Bananagemini-2.5-flash-imageLegacy — shut down by Google on 2027-03-15

Quick Start

  1. Get a Gemini API key from Google AI Studio
  2. Add to your MCP client config (Claude Code example): json { "mcpServers": { "nano-banana": { "command": "npx", "args": ["-y", "github:fjacquet/Nano-Banana-MCP"], "env": { "GEMINI_API_KEY": "your-key-here" } } } }

See docs/configuration.md for Cursor and other MCP clients.

  1. Use the tools: Generate an image of a sunset over mountains Edit this image to add some birds in the sky Continue editing to make it more dramatic

Tools

ToolDescription
generate_imageCreate new images from text prompts
edit_imageModify existing images with optional reference images
continue_editingIteratively edit the last image
get_last_image_infoGet info about the last image
configure_gemini_tokenSet API key
get_configuration_statusCheck configuration

All generation/editing tools accept an optional model parameter to choose between the two models.

See docs/tools.md for full API reference, docs/configuration.md for setup details, and docs/workflows.md for usage patterns.

Development

npm install
npm run dev          # Run with tsx
npm run build        # Compile TypeScript
npm test             # Run tests
npm run lint         # Lint
npm run typecheck    # Type-check

Requires Node.js >= 18.0.0.

License

MIT — see LICENSE.

Fork of ConechoAI/Nano-Banana-MCP.

Frequently asked questions

What is io.github.fjacquet/nano-banana-mcp?

AI image generation and editing with Google Gemini: Nano Banana 2.1, Pro and Lite models

How do I install io.github.fjacquet/nano-banana-mcp?

It runs on your machine. In Claude Code: claude mcp add nano-banana-mcp -e 'GEMINI_API_KEY=<your gemini_api_key>' -- npx -y @fjacquet/nano-banana-mcp@3.2.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.fjacquet/nano-banana-mcp need an API key?

Yes. It expects GEMINI_API_KEY, which you set in its configuration.

Is io.github.fjacquet/nano-banana-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.fjacquet/nano-banana-mcp?

It is published by fjacquet. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.