Gemini Media MCP server

gemini-media-mcp

An MCP server for Google's generative media models: images (Nano Banana 2.1 / Pro), video (Veo 3.1 and Gemini Omni Flash), speech (Gemini 3.8 TTS) and music (Lyria 3.5). It ships as a single Go binary, speaks stdio and Streamable HTTP (MCP 2026-07-28), works with the Gemini API or Vertex AI, and comes with agent skills that teach agents the whole workflow, plus plugin packaging for Claude Code, Codex, Gemini CLI, VS Code/Copilot, Cursor and more.

• Current models, updated without a release. A built-in catalog records IDs, aliases, lifecycle, parameters and prices. Retired models redirect to their replacement, and new model IDs work before the catalog knows them. You can override or extend the catalog with a hot-reloaded YAML file.
• Cost-aware. Every result reports its estimated cost, and estimate_cost compares options before you spend. Spend is recorded in a ledger, capped by session, daily and monthly budgets, and calls above a threshold need explicit approval.
• Agent-friendly. Each tool matches a workflow, and errors come back as [kind] message + Hint. Image results include inline previews, and outputs can be chained by URI. Video runs as async jobs with long-polling and progress notifications.
• Skills included. Six agent skills cover each medium, multi-asset productions and upscaling past 4K. The upscale skill re-renders a photo tile by tile and stitches the tiles into an 8K image.
• Robust. Backend and credentials are detected the way the Google SDKs do it. Vertex locations are chosen per model, retries and timeouts are built in, files are written atomically with provenance, and HTTP mode ships with security defaults.

Upgrading from v0? The tools changed. See the migration table. The review also covers what was broken, why, and the design of v1.

Quick start

1. Get credentials. Either:

• an API key from Google AI Studio (GEMINIAPIKEY), or
• a Google Cloud project with Vertex AI enabled (GOOGLECLOUDPROJECT plus gcloud auth application-default login).

1. Install the binary. On macOS or Linux:

mkdir -p ~/.local/bin   # must be on your PATH
   os=$(uname -s | tr '[:upper:]' '[:lower:]'); arch=$(uname -m | sed 's/x86_64/x64/; s/aarch64/arm64/')
   curl -fsSL "https://github.com/mordor-forge/gemini-media-mcp/releases/latest/download/$os.$arch.gemini-media-mcp.tar.gz" \
     | tar -xz -C ~/.local/bin gemini-media-mcp
   gemini-media-mcp version

On Windows, download the windows zip from the latest release and put gemini-media-mcp.exe on your PATH. With Go 1.26+: go install github.com/mordor-forge/gemini-media-mcp/cmd/gemini-media-mcp@latest.

The Gemini CLI extension, the Claude Desktop bundle and the Docker image include the binary, so they skip this step.

1. Add the server to your agent. Every config below runs gemini-media-mcp from your PATH.

Claude Code (plugin: server plus skills):

/plugin marketplace add mordor-forge/gemini-media-mcp
   /plugin install gemini-media@mordor-forge

or just the server: claude mcp add gemini-media -e GEMINIAPIKEY=... -- gemini-media-mcp

Shortened. The full README is on GitHub.