Gemini MCP Server

by chrischallio.github.chrischall/gemini-mcpv2.3.3

Generate and edit images with Google Gemini (Nano Banana / Nano Banana Pro) image models.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Gemini MCP server

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

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

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

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

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

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

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

{
  "mcpServers": {
    "gemini-chrischall": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/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	Your Google Gemini API key (aistudio.google.com/apikey)
GEMINI_IMAGE_MODEL	—	—	Override the default image model (default: gemini-3.1-flash-image)
GEMINI_OUTPUT_DIR	—	—	Default directory for generated images (default: current working directory)
GEMINI_INPUT_DIR	—	—	Directory to resolve bare input-image filenames against
GEMINI_UPLOAD_DIR	—	—	Restrict local-file uploads to the Gemini Files API to these directories (path.delimiter-separated; unset = unrestricted)
GEMINI_REFERENCE_DIR	—	—	Restrict local reference images (images / image paths sent to Gemini) to these directories (path.delimiter-separated), plus GEMINI_OUTPUT_DIR. Unset: GEMINI_UPLOAD_DIR applies; if that is unset too, unrestricted locally, and $MCP_DATA_DIR/uploads when MCP_DATA_DIR is set (hosted)

Freshness

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

Last commit (default branch)
2026-10-07 · 3d ago · GitHub
Latest release
2026-10-07 · 3d ago · GitHub · v2.3.3
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 3d ago · official registry · v2.3.3

FAQ

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

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

›Does Gemini require an API key?

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

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

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

›Is Gemini in the official MCP registry?

Yes, as io.github.chrischall/gemini-mcp.