Summary
Wraps Google's VEO 3.1 video generation API with nine tools covering text-to-video, image-to-video, interpolation, and video extension at resolutions up to 4K. Uses an async job pattern where you kick off generation, get a job ID, then poll until complete. Includes batch generation for 1-4 videos at once, negative prompts, seed control, and reference image support. Ships alongside a NanoBanana image server in the same repo but published as separate PyPI packages. Handles API key rotation automatically if you provide a backup key. Reach for this when you need programmatic access to VEO's cinematic generation without timeouts or when you want Claude to orchestrate multi-shot video workflows with full parameter control.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
8 tools
veo_list_modelsList all available Veo models and their capabilities. Shows all available model versions with their features, supported actions, and image input rules. Use this to understand which model to choose for your video generation. Model comparison: - veo2/veo2-fast: Standard models,...
List all available Veo models and their capabilities. Shows all available model versions with their features, supported actions, and image input rules. Use this to understand which model to choose for your video generation. Model comparison: - veo2/veo2-fast: Standard models,...
No parameter schema in public metadata yet.
veo_list_actionsList all available Veo API actions and corresponding tools. Reference guide for what each action does and which tool to use. Helpful for understanding the full capabilities of the Veo MCP. Returns: Categorized list of all actions and their corresponding tools.
List all available Veo API actions and corresponding tools. Reference guide for what each action does and which tool to use. Helpful for understanding the full capabilities of the Veo MCP. Returns: Categorized list of all actions and their corresponding tools.
No parameter schema in public metadata yet.
veo_get_prompt_guideGet guidance on writing effective prompts for Veo video generation. Shows how to structure prompts for best video generation results. Following these tips helps Veo understand your vision and generate more accurate and higher quality videos. Returns: Complete guide with prompt...
Get guidance on writing effective prompts for Veo video generation. Shows how to structure prompts for best video generation results. Following these tips helps Veo understand your vision and generate more accurate and higher quality videos. Returns: Complete guide with prompt...
No parameter schema in public metadata yet.
veo_get_taskQuery the status and result of a video generation task. Use this to check if a generation is complete and retrieve the resulting video URLs and metadata. Use this when: - You want to check if a generation has completed - You need to retrieve video URLs from a previous generati...1 params
Query the status and result of a video generation task. Use this to check if a generation is complete and retrieve the resulting video URLs and metadata. Use this when: - You want to check if a generation has completed - You need to retrieve video URLs from a previous generati...
Parameters* required
task_idstringThe task ID returned from a generation request. This is the 'task_id' field from any veo_text_to_video, veo_image_to_video, or veo_get_1080p tool response.
veo_get_tasks_batchQuery multiple video generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling veo_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several video...1 params
Query multiple video generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling veo_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several video...
Parameters* required
task_idsarrayList of task IDs to query. Maximum recommended batch size is 50 tasks.
veo_text_to_videoGenerate AI video from a text prompt using Veo. This creates a video from scratch based on your text description. Veo will interpret your prompt and generate a matching video clip. Use this when: - You want to create a video from a text description - You don't have a reference...6 params
Generate AI video from a text prompt using Veo. This creates a video from scratch based on your text description. Veo will interpret your prompt and generate a matching video clip. Use this when: - You want to create a video from a text description - You don't have a reference...
Parameters* required
modelstringVeo model version. 'veo2' for quality mode, 'veo2-fast' for faster generation. 'veo3'/'veo31' offer improved quality. Models with '-fast' suffix are faster but slightly lower quality.one of
veo2 · veo2-fast · veo3 · veo3-fast · veo31 · veo31-fastdefault: veo2promptstringDescription of the video to generate. Be descriptive about scene, subject, action, camera movement, lighting, and style. Examples: 'A white ceramic coffee mug on a glossy marble countertop, steam rising, soft morning light', 'Cinematic drone shot over a forest at sunset, golden hour lighting'
resolutionvalueVideo resolution. Options: '4k' for highest quality, '1080p' for standard HD, 'gif' for animated GIF format. If not specified, uses the model's default resolution.
translationbooleanIf true, automatically translate the prompt to English for better generation quality. Useful for non-English prompts.default: false
aspect_ratiostringVideo aspect ratio. '16:9' for landscape/widescreen, '9:16' for portrait/vertical, '1:1' for square, '4:3' for standard, '3:4' for portrait standard.one of
16:9 · 9:16 · 3:4 · 4:3 · 1:1default: 16:9callback_urlstringOptional URL to receive a POST callback when generation completes. The callback will include the task_id and video results.default:
veo_image_to_videoGenerate AI video from one or more reference images using Veo. This creates a video using your image(s) as reference frames. The video will animate from/between your provided images according to the prompt. Image modes: - 1 image: First-frame mode - the video starts from your...7 params
Generate AI video from one or more reference images using Veo. This creates a video using your image(s) as reference frames. The video will animate from/between your provided images according to the prompt. Image modes: - 1 image: First-frame mode - the video starts from your...
Parameters* required
modelstringVeo model version. Note: 'veo31-fast-ingredient' is for multi-image fusion mode only. Other models support 1 image (first frame) or 2-3 images (first/last frame).one of
veo2 · veo2-fast · veo3 · veo3-fast · veo31 · veo31-fastdefault: veo2promptstringDescription of the video motion and action. Describe what should happen to the subject in the image. Examples: 'The coffee steam rises gently', 'The person turns and smiles at the camera', 'Camera slowly zooms out revealing the landscape'
image_urlsarrayList of image URLs to use as reference. For first-frame mode, provide 1 image. For first-last frame mode, provide 2-3 images. The first image is the starting frame, the last image is the ending frame. Maximum 3 images.
resolutionvalueVideo resolution. Options: '4k' for highest quality, '1080p' for standard HD, 'gif' for animated GIF format.
translationbooleanIf true, automatically translate the prompt to English for better generation quality.default: false
aspect_ratiostringVideo aspect ratio. Should typically match your input image aspect ratio for best results.one of
16:9 · 9:16 · 3:4 · 4:3 · 1:1default: 16:9callback_urlstringOptional URL to receive a POST callback when generation completes.default:
veo_get_1080pGet the 1080p high-resolution version of a generated video. By default, Veo generates videos at a lower resolution for faster processing. Use this tool to get the full 1080p version of a completed video. Use this when: - You need a higher resolution version for production use...1 params
Get the 1080p high-resolution version of a generated video. By default, Veo generates videos at a lower resolution for faster processing. Use this tool to get the full 1080p version of a completed video. Use this when: - You need a higher resolution version for production use...
Parameters* required
video_idstringThe video ID from a previous generation result. This is the 'id' field from the video data, not the task_id.
Gemini Media MCP
All-in-one MCP toolkit for AI media generation -- VEO 3.1 video + NanoBanana Pro 2 images + prompting skills
What's Included • Quick Start • VEO Server • NanoBanana Server • Skills • Contributing
| CLI | Install check | Version check |
|---|---|---|
veo-mcp-server | veo-mcp-server --help | veo-mcp-server --version |
nanobanana-imagen-mcp | nanobanana-imagen-mcp --help | nanobanana-imagen-mcp --version |
What is This?
Gemini Media MCP is a comprehensive toolkit that brings Google's most powerful AI media generation models into any MCP-compatible AI assistant. Generate 4K videos with VEO 3.1, create stunning images with NanoBanana Pro 2, and craft professional prompts with built-in skills -- all from a single repository.
What's Included
MCP Servers
| Server | Description | Tools |
|---|---|---|
| VEO 3.1 | AI video generation (text-to-video, image-to-video, extend, interpolate) | 9 tools |
| NanoBanana | AI image generation with NanoBanana Pro 2 (Pro + Flash models) | 4 tools |
Claude Code Skills (Plugin Marketplace)
| Skill | Description |
|---|---|
| VEO Prompting | 7-layer prompt engineering for cinematic VEO 3.1 videos |
| NanoBanana Prompting | 7-layer prompt engineering for photorealistic NanoBanana Pro 2 images |
Install skills via Claude Code:
/plugin marketplace add u2n4/gemini-media-mcp
Quick Start
This repo hosts two independent MCP servers. Install whichever you need — or both. Each server publishes to PyPI separately.
Option A — uvx (zero-install, recommended)
Add a block to your MCP client config (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf) using the appropriate server block below (see VEO Server / NanoBanana Server sections).
Option B — clone + editable install
git clone https://github.com/u2n4/gemini-media-mcp.git
cd gemini-media-mcp
# Create a virtual environment (uv pip install requires one — or pass --system)
uv venv
source .venv/bin/activate # macOS / Linux
# .venv\Scripts\activate # Windows PowerShell
# Install one or both sub-packages
uv pip install -e servers/veo
uv pip install -e servers/nanobanana
VEO Server
uvx (zero-install):
{
"mcpServers": {
"veo": {
"command": "uvx",
"args": ["veo-mcp-server"],
"env": {
"GEMINI_API_KEY": "your_key",
"VIDEO_OUTPUT_DIR": "./videos"
}
}
}
}
Claude Code:
claude mcp add veo -s user -e GEMINI_API_KEY=your_key -- uvx veo-mcp-server
pip install:
pip install veo-mcp-server
NanoBanana Server
uvx (zero-install):
{
"mcpServers": {
"nanobanana": {
"command": "uvx",
"args": ["nanobanana-imagen-mcp"],
"env": {
"GEMINI_API_KEY": "your_key"
}
}
}
}
Claude Code:
claude mcp add nanobanana -s user -e GEMINI_API_KEY=your_key -- uvx nanobanana-imagen-mcp
pip install:
pip install nanobanana-imagen-mcp
VEO Server
AI video generation powered by Google VEO 3.1. Uses an async job pattern where generation starts in the background and returns a job ID for polling -- no timeouts.
Tools
| Tool | Description |
|---|---|
veo_generate_video | Generate video from text prompt. Supports 720p/1080p/4K, 16:9 or 9:16, 4/6/8 second duration, negative prompts, reference images, seed control, and batch generation (1-4 videos). |
veo_image_to_video | Animate a reference image with a motion prompt. |
veo_interpolate_video | Create smooth transition between two frames (first frame + last frame). |
veo_extend_video | Extend an existing VEO video by ~7 seconds. 720p only, max 148 seconds total. |
veo_check_job | Check async job status. Call every 15-20 seconds until completed or failed. |
veo_list_jobs | List all generation jobs and their current status. |
veo_api_status | Check API key status -- keys configured, active key, keys remaining. |
veo_pricing_info | Show pricing per second for standard and fast models at all resolutions. |
veo_show_output_stats | Display generation statistics -- video count, total size, file details, job statuses. |
VEO Configuration
| Variable | Description | Default |
|---|---|---|
GEMINI_API_KEY | Primary API key (required) | -- |
GEMINI_API_KEY_BACKUP | Backup key for auto-rotation | -- |
VIDEO_OUTPUT_DIR | Output directory for videos | ~/veo-videos |
VEO Models
| Tier | Model | Best For |
|---|---|---|
| Standard | veo-3.1-generate-preview | Higher quality output |
| Fast | veo-3.1-fast-generate-preview | Quicker generation |
NanoBanana Server
AI image generation powered by NanoBanana Pro 2. Supports Pro (maximum quality) and Flash (fast) models with default 4K resolution.
Tools
| Tool | Description |
|---|---|
generate_image | Generate images using NanoBanana Pro 2 (Pro or Flash). Supports aspect ratio, resolution (up to 4K), negative prompts, thinking level, grounding, and reference images. |
upload_file | Upload reference image for editing or conditioning. |
show_output_stats | Display generation statistics -- image count, total size, file details. |
maintenance | Server maintenance and cleanup -- clear caches, remove temporary files. |
Models
| Model | Engine | Best For |
|---|---|---|
| Pro | Gemini 3 Pro Image | Maximum quality, complex scenes |
| Flash | Gemini 3.1 Flash Image | Fast generation, simple scenes |
Prompting Skills
VEO Prompting Skill
7-layer prompt engineering system for VEO 3.1:
- Cinematography (camera, shot type, lens, angles)
- Subject (characters, objects, material cues)
- Action (force-based verbs, timestamp beats)
- Environment (time of day, weather, depth layers)
- Lighting & Mood (physical light sources, color temperature)
- Audio Design (dialogue, SFX, ambient, music)
- Technical Controls (negative prompts, style anchors, film stocks)
NanoBanana Prompting Skill
7-layer prompt engineering system for NanoBanana Pro 2:
- Style & Art Direction (visual DNA)
- Scene Description (environment, atmosphere)
- Main Subject (hero element with extreme specificity)
- Camera & Lens (real camera specs for realism)
- Lighting (natural, studio, color temperature)
- Texture, Material & Color (tactile detail)
- Negative Prompts (quality guards)
Architecture
gemini-media-mcp/
├── servers/
│ ├── veo/ # VEO 3.1 MCP Server (PyPI: veo-mcp-server)
│ │ ├── pyproject.toml
│ │ ├── requirements.txt
│ │ └── src/
│ │ └── veo_mcp_server/
│ │ ├── __init__.py
│ │ ├── __main__.py
│ │ └── server.py
│ └── nanobanana/ # NanoBanana MCP Server (PyPI: nanobanana-imagen-mcp)
│ ├── pyproject.toml
│ ├── requirements.txt
│ └── nanobanana_mcp_server/ # Package
├── skills/
│ ├── veo-prompting/ # VEO prompting skill
│ │ └── SKILL.md
│ └── nanobanana-prompting/ # NanoBanana prompting skill
│ └── SKILL.md
├── plugins/ # Claude Code Plugin Marketplace
│ ├── veo-prompting/
│ │ ├── .claude-plugin/
│ │ │ └── plugin.json
│ │ └── skills/
│ │ └── veo-prompting/
│ │ └── SKILL.md
│ └── nanobanana-prompting/
│ ├── .claude-plugin/
│ │ └── plugin.json
│ └── skills/
│ └── nanobanana-prompting/
│ └── SKILL.md
├── .claude-plugin/
│ └── marketplace.json
├── .env.example
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── llms.txt
└── llms-install.md
Contributing
See CONTRIBUTING.md.
License
MIT -- see LICENSE.
Credits
- NanoBanana MCP Server: inspired by the nano-banana naming convention used across the MCP community. This is an independent implementation.
- VEO 3.1 by Google DeepMind
Support
If you find this useful, please star this repository!
Made with ❤️ in the Eastern Province of Saudi Arabia.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
Packageveo-mcp-server
TransportSTDIO
UpdatedApr 19, 2026
