Ultimate Gemini MCP Server

by nikshipsio.github.nikships/ultimate-image-gen-mcpv6.0.21

Image generation with Google Gemini 3.1 Flash: 512px-4K, reference images, search grounding

14Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active17d ago

Install Ultimate Gemini MCP server

claude mcp add ultimate-gemini -e GEMINI_API_KEY='<gemini-api-key>' -- uvx ultimate-gemini-mcp

{
  "mcpServers": {
    "ultimate-gemini": {
      "command": "uvx",
      "args": [
        "ultimate-gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ultimate-gemini": {
      "command": "uvx",
      "args": [
        "ultimate-gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

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

{
  "servers": {
    "ultimate-gemini": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ultimate-gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ultimate-gemini": {
      "command": "uvx",
      "args": [
        "ultimate-gemini-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	Google Gemini API key (free tier at https://aistudio.google.com/apikey). Also accepts GOOGLE_API_KEY.
OUTPUT_DIR	—	—	Directory where generated images are saved
DEFAULT_IMAGE_SIZE	—	—	Default resolution for generated images
DEFAULT_MODEL	—	—	Default Gemini image model
ENABLE_PROMPT_ENHANCEMENT	—	—	Automatically enhance prompts with Gemini Flash before generation
ENABLE_GOOGLE_SEARCH	—	—	Enable Google Search grounding by default (real-time data like weather, events)
REQUEST_TIMEOUT	—	—	API request timeout in seconds
MAX_BATCH_SIZE	—	—	Max parallel requests in batch mode
LOG_LEVEL	—	—	Logging level

Freshness

Active — last maintenance signal 17d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-23 · 17d ago · GitHub
Latest release
2026-09-23 · 17d ago · GitHub · v6.0.21
Package published
no data · npm/PyPI
Registry entry updated
2026-09-23 · 17d ago · official registry · v6.0.21

FAQ

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

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

›Does Ultimate Gemini require an API key?

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

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

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

›Is Ultimate Gemini in the official MCP registry?

Yes, as io.github.nikships/ultimate-image-gen-mcp.