Gemini-mcp Server

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

Local serverstdio

What is the Gemini-mcp Server?

Gemini-mcp is an MCP integration. Generate and edit images with Google Gemini (Nano Banana / Nano Banana Pro) image models.

Packages and local setup

The published npm package is @chrischall/gemini-mcp, version 2.3.3. Its declared MCP transport is stdio.

The package declares GEMINI_API_KEY (required): 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).

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 2.3.3 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
GEMINI_API_KEYYour Google Gemini API key (aistudio.google.com/apikey)Yes
GEMINI_IMAGE_MODELOverride the default image model (default: gemini-3.1-flash-image)Optional
GEMINI_OUTPUT_DIRDefault directory for generated images (default: current working directory)Optional
GEMINI_INPUT_DIRDirectory to resolve bare input-image filenames againstOptional
GEMINI_UPLOAD_DIRRestrict local-file uploads to the Gemini Files API to these directories (path.delimiter-separated; unset = unrestricted)Optional
GEMINI_REFERENCE_DIRRestrict 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)Optional