Nano Banana MCP

Nano Banana MCP

MCP server for AI image generation and editing using Google Gemini image models.

Models

| Product | Model ID | Default | |---------|----------|---------| | Nano Banana 2 | gemini-3.1-flash-image-preview | Yes | | Nano Banana | gemini-2.5-flash-image | No | | Nano Banana Pro | gemini-3-pro-image-preview | No |

Setup

npx nano-banana-mcp setup

This interactive wizard lets you choose:

1. Google OAuth (default) -- opens browser for one-click authorization
2. API Key -- paste your key from Google AI Studio

MCP Client Configuration

Claude Code

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"]
    }
  }
}

Tools

generate_image

Create an image from a text prompt.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | prompt | string | Yes | Text description of the image to generate | | model | string | No | Model ID (defaults to gemini-3.1-flash-image-preview) | | aspectRatio | string | No | One of 1:1, 16:9, 9:16, 4:3, 3:4 (default: 1:1) |

edit_image

Edit an existing image using a text prompt.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | prompt | string | Yes | Instructions for how to edit the image | | imagePath | string | Yes | Path to the source image | | referenceImages | string[] | No | Paths to reference images for style/context | | model | string | No | Model ID |

continue_editing

Refine the last generated or edited image.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | prompt | string | Yes | Refinement instructions | | model | string | No | Model ID |

configure_auth

Set a Gemini API key at runtime.

get_status

Check auth state, current model, and output directory.

get_last_image

Get metadata about the most recently generated/edited image.

list_models

List available models with current default.

Environment Variables

| Variable | Description | |----------|-------------| | NANO_BANANA_CLIENT_ID | Override embedded OAuth client ID | | NANO_BANANA_CLIENT_SECRET | Override embedded OAuth client secret | | GEMINI_API_KEY | Gemini API key (skips stored credentials) | | NANO_BANANA_OUTPUT_DIR | Custom image output directory | | NANO_BANANA_CONFIG_DIR | Custom config directory |

Development

npm install
npm run build
npm test
npm run test:coverage

License

MIT