Nanobanana MCP vs Nanobanana MCP Server

A side-by-side look at the Nanobanana MCP and Nanobanana MCP Server MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.

Nanobanana MCP logoNanobanana MCPMultimedia Process · Local subprocess (stdio)Lean MCP server for Google's Nano Banana (Gemini) image models. Returns file paths, not base64.52GoodAuth: not declaredNanobanana MCP Server logoNanobanana MCP ServerMultimedia Process · Local subprocess (stdio)AI image generation with Gemini 3 Pro (4K) and 2.5 Flash. Smart model selection.63GoodAuth: not declared

Verdict: choose Nanobanana MCP for multimedia process work as a local process; choose Nanobanana MCP Server for multimedia process as a local process. You can also run both side by side in one mcpServers block.

Which MCP server should you choose?

Nanobanana MCP logoChoose Nanobanana MCP when

  • You need dedicated capabilities in the Multimedia Process domain.
  • You prefer a local stdio subprocess transport.
  • You have the keys it needs: GEMINI_API_KEY, GOOGLE_API_KEY, NANOBANANA_MODEL, NANOBANANA_VIDEO_MODEL, NANOBANANA_OUTPUT_DIR.
  • You want tools like generate_image, edit_image, list_models.
Explore Nanobanana MCP

Nanobanana MCP Server logoChoose Nanobanana MCP Server when

  • You need dedicated capabilities in the Multimedia Process domain.
  • You prefer a local stdio subprocess transport.
  • You have the keys it needs: GEMINI_API_KEY, NANOBANANA_AUTH_METHOD, GCP_PROJECT_ID, GCP_REGION.
  • You want tools like generate_image, upload_file, show_output_stats.
Explore Nanobanana MCP Server

Feature & specification comparison

Rows where the two servers differ are marked.

SpecNanobanana MCP logoNanobanana MCPNanobanana MCP Server logoNanobanana MCP Server
CategoryMultimedia ProcessMultimedia Process
Quality signal52/100 · Good63/100 · Good
Install commandConfirmedConfirmed
TransportLocal subprocess (stdio)Local subprocess (stdio)
AuthNot declaredNot declared
PricingNot declaredNot declared
Required env varsGEMINI_API_KEYGOOGLE_API_KEYNANOBANANA_MODELNANOBANANA_VIDEO_MODELNANOBANANA_OUTPUT_DIRGEMINI_API_KEYNANOBANANA_AUTH_METHODGCP_PROJECT_IDGCP_REGION
Verified ownerCommunity listingCommunity listing
GitHub stars1402
Directory activity 0 views 0 installs 0 upvotes 1 views 0 installs 0 upvotes
Tools34

Tools & capabilities

Nanobanana MCP tools 3

  • generate_image
  • edit_imageSame params, plus:
  • list_modelsTakes no params. Lists the image and video model ids your API key can use, in two

Nanobanana MCP Server tools 4

  • generate_imageGenerate new images or edit existing images using natural language instructions. Supports multiple input modes: 1. Pure generation: Just provide a prompt to create new images 2. Multi-image conditioning: Provide up to 3 input images using input_image_path_1/2/3 parameters 3. File ID editing: Edit previously uploaded images using Files API ID 4. File path editing: Edit local images by providing single input image path Automatically detects mode based on parameters or can be explicitly controlled. Input images are read from the local filesystem to avoid massive token usage. Returns both MCP image content blocks and structured JSON with metadata.
  • upload_fileUpload a local file through the Gemini Files API and return its URI & metadata. Useful when the image is larger than 20MB or reused across prompts.
  • show_output_statsShow statistics about the output directory and recently generated images.
  • maintenancePerform maintenance operations following workflows.md patterns. Available operations: - cleanup_expired: Remove expired Files API entries from database - cleanup_local: Clean old local files based on age/LRU - check_quota: Check Files API storage usage vs. ~20GB budget - database_hygiene: Clean up database inconsistencies - full_cleanup: Run all cleanup operations in sequence

Ready-to-paste client configs

Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.

Nanobanana MCP

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "nanobanana-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nanobanana/mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY_HERE",
        "NANOBANANA_MODEL": "YOUR_NANOBANANA_MODEL_HERE",
        "NANOBANANA_VIDEO_MODEL": "YOUR_NANOBANANA_VIDEO_MODEL_HERE",
        "NANOBANANA_OUTPUT_DIR": "YOUR_NANOBANANA_OUTPUT_DIR_HERE"
      }
    }
  }
}

Nanobanana MCP Server

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "nanobanana-mcp-server": {
      "command": "uvx",
      "args": [
        "nanobanana-mcp-server@latest"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE",
        "NANOBANANA_AUTH_METHOD": "YOUR_NANOBANANA_AUTH_METHOD_HERE",
        "GCP_PROJECT_ID": "YOUR_GCP_PROJECT_ID_HERE",
        "GCP_REGION": "YOUR_GCP_REGION_HERE"
      }
    }
  }
}

Frequently asked questions

Nanobanana MCP is categorized under Multimedia Process and uses a local stdio subprocess. Nanobanana MCP Server belongs to Multimedia Process and uses a local stdio subprocess. Pick Nanobanana MCP for multimedia process work and Nanobanana MCP Server for multimedia process.

Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.

Nanobanana MCP has no declared pricing — check the project's own site. Nanobanana MCP Server has no declared pricing — check the project's own site. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.

Yes. MCP clients support multiple servers: add nanobanana-mcp and nanobanana-mcp-server as separate keys in the same mcpServers object, and your assistant will call tools from either one.

On AllMCPs, Nanobanana MCP has a quality signal of 52/100 (Good) with 0 views, 0 installs and 1 GitHub stars. Nanobanana MCP Server has 63/100 (Good) with 1 views, 0 installs and 402 GitHub stars.