Skip to content
MCP server

Nanobanana MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.2
Listing updated
5 days ago

About Nanobanana MCP

Nanobanana MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add nanobanana-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y @nanobanana/mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GEMINI_API_KEYGemini API key from https://aistudio.google.com/apikeyRequired
  • NANOBANANA_MODELDefault image model override (default: gemini-3.1-flash-image)
  • NANOBANANA_OUTPUT_DIRDefault output directory override

Pricing

Open source

Nanobanana MCP FAQ

Is Nanobanana MCP free?

Yes. Nanobanana MCP is open source, so you can use and self-host it for free.

How do I add Nanobanana MCP to Claude Code?

Run this command in your terminal: claude mcp add nanobanana-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y @nanobanana/mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers