Nanobanana MCP Server

by getjoystickio.github.getjoystick/nanobanana-mcpv0.1.2

Lean MCP server for Google's Nano Banana (Gemini) image models. Returns file paths, not base64.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained57d ago

Install Nanobanana MCP server

claude mcp add nanobanana -e GEMINI_API_KEY='<gemini-api-key>' -- npx -y @nanobanana/mcp

{
  "mcpServers": {
    "nanobanana": {
      "command": "npx",
      "args": [
        "-y",
        "@nanobanana/mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "nanobanana": {
      "command": "npx",
      "args": [
        "-y",
        "@nanobanana/mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "nanobanana": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nanobanana/mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "nanobanana": {
      "command": "npx",
      "args": [
        "-y",
        "@nanobanana/mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GEMINI_API_KEY	yes	yes	Gemini API key from https://aistudio.google.com/apikey
NANOBANANA_MODEL	—	—	Default image model override (default: gemini-3.1-flash-image)
NANOBANANA_OUTPUT_DIR	—	—	Default output directory override

Freshness

Maintained — last maintenance signal 57d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-14 · 57d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-02 · 3mo ago · official registry · v0.1.2

FAQ

›How do I install the Nanobanana MCP server in Claude Code?

Run: claude mcp add nanobanana -e GEMINI_API_KEY='<gemini-api-key>' -- npx -y @nanobanana/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Nanobanana require an API key?

Yes. It expects GEMINI_API_KEY, of which 1 is a secret.

›Can I use Nanobanana as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Nanobanana in the official MCP registry?

Yes, as io.github.getjoystick/nanobanana-mcp.