Skip to main content
Glama
Sign In
Nano Banana MCP

Nano Banana MCP

by DevShiftTeam
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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

Related MCP server: Gemini Gen MCP

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

Available Tools

7 tools
configure_authConfigure AuthenticationA
Idempotent

Set a Gemini API key for authentication. Get your key from Google AI Studio (https://aistudio.google.com/apikey).

Inputs: apiKey (required). Returns: message

continue_editingContinue EditingA

Refine the last generated or edited image with a new prompt. Must call generate_image or edit_image first. Returns the file path of the saved result.

Inputs: prompt (required), model. Returns: model, filePath, sizeBytes

edit_imageEdit ImageA

Edit an existing image using a text prompt. Optionally provide reference images for style guidance. Returns the file path of the saved result.

Inputs: prompt (required), imagePath (required), model, referenceImages. Returns: model, filePath, sizeBytes

generate_imageGenerate ImageA

Create a new image from a text prompt using Google Gemini image models. Returns the file path of the saved image.

Inputs: prompt (required), model, aspectRatio. Returns: model, filePath, sizeBytes

get_last_imageGet Last ImageA
Read-onlyIdempotent

Get metadata about the most recently generated or edited image, including file path, MIME type, timestamp, and size.

Inputs: no named parameters.

get_statusGet StatusA
Read-onlyIdempotent

Check current authentication state, active model, and image output directory. Use this to verify setup before generating images.

Inputs: no named parameters. Returns: auth, outputDir, currentModel

list_modelsList ModelsA
Read-onlyIdempotent

List all available Gemini image models with their product name, ID, and whether they are the default. Use model IDs when calling generate_image, edit_image, or continue_editing.

Inputs: no named parameters. Returns: models

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation4/5

    Each tool has a distinct role, but edit_image and continue_editing both modify an image based on a prompt, so an agent might briefly hesitate between them. The dependency note on continue_editing and the 'existing image' wording in edit_image reduces but does not eliminate this overlap.

    Naming Consistency5/5

    All tool names use a consistent snake_case verb-first pattern: list_models, generate_image, edit_image, configure_auth, get_status, get_last_image. continue_editing fits the same pattern despite using a gerund rather than a simple noun.

    Tool Count5/5

    Seven tools is well-scoped for a focused image-generation/editing server. Each tool covers a necessary part of the workflow without redundancy or bloat.

    Completeness5/5

    The surface covers authentication, model discovery, generation, editing, iterative refinement, status checking, and access to the latest output metadata. There are no obvious dead ends; model selection is handled via parameters, and image files are returned as paths.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches