MCP.so
Sign In

Gemini Nanobanana Mcp

@Junhan2

About Gemini Nanobanana Mcp

MCP server for Google Gemini 2.5 Flash Image preview (text-to-image, editing, composition)

Basic information

Category

AI & Agents

License

MIT

Runtime

node

Transports

stdio

Publisher

Junhan2

Submitted by

gangjoon

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": [
        "gemini-nanobanana-mcp@latest"
      ],
      "env": {
        "GEMINI_API_KEY": "your-api-key",
        "AUTO_SAVE": "true",
        "DEFAULT_SAVE_DIR": "~/Pictures/AI-Images",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Gemini Nanobanana Mcp?

Gemini Nanobanana Mcp is a beginner-friendly Model Context Protocol (MCP) server that brings Google’s Gemini 2.5 Flash image generation directly into Claude conversations. It enables text-to-image generation, image editing, multi-image composition, and style transfer—all through natural language prompts.

How to use Gemini Nanobanana Mcp?

Configure the server in Claude Desktop, Claude Code, or Cursor by adding a JSON entry with the npx command and your GEMINI_API_KEY environment variable. After restarting your client, simply ask Claude to generate, edit, or compose images. Images are auto-saved to ~/Downloads/gemini-images/ by default, and you can specify a custom path in your prompt.

Key features of Gemini Nanobanana Mcp

  • Text-to-image generation from any description
  • Edit uploaded images with natural language instructions
  • Combine multiple images into a collage or composition
  • Apply artistic style from one image to another
  • Auto‑save images to disk or disable with AUTO_SAVE=false
  • Optional HTTP mode for external integrations

Use cases of Gemini Nanobanana Mcp

  • Generate custom illustrations, logos, or concept art during a chat
  • Edit photos by describing the desired change (e.g., “make this black and white”)
  • Create collages by uploading multiple reference images
  • Apply a style reference image to a content image for artistic transfer
  • Automatically save every generated image to a local folder for later use

FAQ from Gemini Nanobanana Mcp

What API key is required and where do I get it?

You need a Google AI Studio API key. Get one free at Google AI Studio by signing in with your Google account.

How do I install Gemini Nanobanana Mcp in Claude Desktop on Mac?

Open Terminal and run the one‑line command provided in the README that writes the configuration JSON to ~/Library/Application Support/Claude/claude_desktop_config.json, replacing YOUR_API_KEY with your actual key.

Why am I getting “GEMINI_API_KEY not set” error?

The API key is missing or incorrectly set. Double‑check your config file or environment variable, ensure there are no extra spaces, and restart your Claude client.

Can I change where images are saved or disable automatic saving?

Yes. Set DEFAULT_SAVE_DIR to a custom path, or set AUTO_SAVE to false to only save images when you explicitly request a path.

What image formats are supported and how do I get instant preview?

Supported formats: PNG, JPEG, WebP, and GIF. For instant preview in Claude Code, install the provided hooks from the repository—generated images will open automatically in Quick Look.

Comments

More AI & Agents MCP servers