Gemini Omni MCP

MCP server for Google's Gemini Omni Flash video model — text-to-video, image-to-video, reference-guided video, and conversational video editing with native audio, straight from your AI agent.

Setup

Get a Gemini API key from Google AI Studio, then add the server to your MCP config.

Claude Desktop / Claude Code / Cursor

Add to your MCP config (mcp.json / .claude.json / claude_desktop_config.json):

{
  "mcpServers": {
    "gemini-omni": {
      "command": "uvx",
      "args": ["gemini-omni-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Droid CLI

droid mcp add gemini-omni "uvx gemini-omni-mcp@latest" --env GEMINI_API_KEY=your-api-key-here

Generated MP4s are saved to ~/gemini_omni_videos by default (set OUTPUT_DIR to change).

Related MCP server: veo-mcp-server

Features

• Text-to-video: prompt-only MP4 generation with generated audio (music, ambience, SFX)

• Image-to-video: animate a single reference image with motion and camera direction

• Reference-to-video: up to 6 reference images to lock subjects, style, or props

• Conversational editing: iterate on a generated video via previous_interaction_id, or upload your own MP4 and edit it

• Prompt role tags: <FIRST_FRAME> and <IMAGE_REF_N> bind reference images to roles

• Timing cues: [0-3s], [3-6s], [6-10s] direct the action beat by beat

• Batch generation: run multiple prompts in conservative parallel batches (max 4)

• URI or inline delivery: robust Files API polling and download built in

Output is 720p 24fps MP4 with SynthID watermarking (preview-quality model).

Showcase

All videos below were generated by this server with gemini-omni-flash-preview, sound on.

Corgi on a hoverboard

A corgi wearing tiny goggles rides a glowing hoverboard through a neon-lit Tokyo street at night, rain reflections on the pavement, camera tracking alongside, single continuous shot, cinematic lighting, upbeat synthwave music.

https://github.com/user-attachments/assets/4b9a8e87-7db0-469d-a261-3c354f7fe9b8

Astronaut latte art

An astronaut in a white spacesuit pours latte art into a floating cup inside a cozy moon-base cafe, Earth visible through a large window, steam swirling in low gravity, slow dolly-in, warm lighting, gentle ambient cafe sounds.

https://github.com/user-attachments/assets/88072ef8-1ce4-4c80-a05a-bfb5531d1271

Origami ocean

An origami paper whale swims gracefully through a stylized paper-craft ocean, paper waves folding and unfolding, paper seagulls gliding above, soft sunlight, camera slowly orbiting, calm orchestral score.

https://github.com/user-attachments/assets/c1e31341-e53c-4a55-af12-d6bb9432dcf5

Tools

generate_video

Generates or edits one MP4 and returns JSON with video.path, interaction_id, and metadata.

batch_generate

Runs multiple prompts in parallel batches, capped at 4.

Configuration

Everything is configured through environment variables (or a local .env):

Prompting tips

• Ask for a "single continuous shot" and "no scene cuts" for one-scene outputs.

• Always include audio direction, for example "gentle ambient sound, no dialogue".

• For edits, keep the prompt short and add "Keep everything else the same".

• Use <FIRST_FRAME> and <IMAGE_REF_N> tags to bind reference-image roles.

• Timing cues like [0-3s], [3-6s], and [6-10s] work well.

Limitations

• Preview model: 720p, 24fps, MP4 only, SynthID-watermarked.

• System instructions, temperature, negative prompts, voice edits, YouTube sources, and multi-video reasoning are unsupported.

• Uploaded-video editing is unavailable in some regions.

Development

git clone https://github.com/nikships/gemini-omni-mcp
cd gemini-omni-mcp
uv sync --all-extras
uv run ruff format .
uv run ruff check .
uv run mypy gemini_omni_mcp/
uv run pytest
uv build

Releases are automated: every push to main bumps the version and publishes to PyPI (see PUBLISHING.md).

License

Gemini Omni MCP is licensed under the MIT license. See LICENSE for details.