Nano Banana MCP

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

Models

npx nano-banana-mcp setup

This interactive wizard lets you choose:

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

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

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

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 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

Refine the last generated or edited image.

Set a Gemini API key at runtime.

Check auth state, current model, and output directory.

Get metadata about the most recently generated/edited image.

List available models with current default.

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

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

MIT