veo-mcp
Generate and retrieve Google Veo videos through an MCP client, with MP4 files saved locally.
Generate videos from text prompts, optionally using an image as the first frame and another as the last frame.
Control generation with negative prompts, seeds, aspect ratio (
16:9/9:16), duration (4/6/8seconds), resolution (720p/1080p/4k), model, filename, and output directory.Wait for renders while sending MCP progress notifications, then return the saved MP4 path.
Fetch and save an already-running Veo operation by its operation name, avoiding duplicate cost after a failed
generate_videocall.List Veo model IDs available to the configured Gemini API key.
Generates videos with Google Veo through the Gemini REST API, supporting text-to-video and image-to-video (first frame/last frame) renders with options for aspect ratio, duration, resolution, seed, and model, polling the render until completion and saving the resulting MP4 to disk. Also lists the Veo models available to an API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@veo-mcp generate an 8 second 16:9 video of a snowy mountain peak at sunrise"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that gives Claude Code, Claude Desktop or any other MCP client video generation with Google Veo. It talks to the Gemini API directly: text-to-video, image-to-video and a transition between a first and a last frame. The MP4 is saved on the machine that runs the server.
Tools
generate_videostarts a render, waits for it and saves the MP4. Takes apromptand, optionally:image, the first frame (png, jpg, webp), andlastFrame, which needsimage;negativePrompt,seed;aspectRatio:16:9(default) or9:16;durationSeconds: 4, 6 or 8 (default);1080pand4kneed 8;resolution:720p(default),1080por4k;model(veo-3.1-generate-previewby default),filename,outputDir.
Returns the file path. While it waits, it sends MCP progress notifications, so the client doesn't time the call out.
fetch_videowaits for a render that is already running and saves it by its operation name. Whengenerate_videofails after the render started, its error names the operation:fetch_videopicks it up without paying twice.list_modelslists the Veo models your key can use.
Veo is billed per second of video and a render takes one to five minutes, so the tool asks the model to check before generating several variants. Network errors, 429 and 5xx are retried with backoff. When the safety filter drops a video, the error says why.
Related MCP server: Vidu MCP
Setup
Node 26 or newer. Add the server to your MCP config, see .mcp.json.example:
{
"mcpServers": {
"veo": {
"command": "npx",
"args": ["-y", "@aimuzov/veo-mcp"],
"env": { "GEMINI_API_KEY": "your-api-key", "VEO_OUTPUT_DIR": "./veo" }
}
}
}Get a key at AI Studio, Veo needs a project with billing enabled. Without a key the server still starts, and every tool answers with that hint.
The server runs only over stdio: a video is a file on the disk of the machine that made it, a hosted connector would leave it on someone else's server.
Variable | Default | What it does |
| Gemini API key, required | |
|
| Where videos are saved |
|
| How often to poll the render |
|
| When to give up on a render |
|
|
|
Development
npm install
npm start # the TypeScript sources over stdio, no build
npm test
npm run lint
npm run typecheck
npm run build # build/ for the npm packageShared helpers and the CI steps come from infra-mcp-kit, formatting and lint rules from infra-site-kit.
License
Available Tools
3 toolsfetch_videoFetch a Veo video by operationA
Wait for an already started Veo operation and save its video. Use it when generate_video failed after the render had started: its error names the operation. Costs nothing extra.
Inputs: operation (required), filename, outputDir.
generate_videoGenerate a video with VeoA
Generate a video from a text prompt with Google Veo, optionally starting from an image (image-to-video) and ending on another one. Paid per second of video and takes 1-5 minutes, so ask before generating several variants. Saves an MP4 to disk and returns its path.
Inputs: prompt (required), seed, image, model, +7 more.
list_modelsList Veo modelsA
List Veo model ids available to this API key.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct role: list_models discovers model ids, generate_video starts a paid render, and fetch_video recovers an already-started operation. The descriptions explicitly distinguish starting a new render from fetching an existing one.
All three tools follow a consistent snake_case verb_noun pattern: list_models, generate_video, fetch_video. There is no mixing of conventions or vague standalone verbs.
Three tools is a tight, well-scoped surface for a video-generation server: discovery, generation, and recovery are each covered without redundancy. No tool feels extraneous.
The core workflow is covered: list available models, generate text/image-to-video, and fetch a video from a started operation. Minor gaps exist around operation management, such as checking status without fetching or cancelling a render, but these are not critical for the stated use case.
Maintenance
Related MCP Connectors
Plan, compare, price, generate, and recover AI video from compatible MCP clients.
Generate AI video from any MCP client. Pick the model, see the per-second price before you spend.
Generate AI images and videos from any compatible MCP client.
MCP server for Google Veo AI video generation
Related MCP Servers
- AlicenseBqualityCmaintenanceMCP server that exposes Google's Veo2 video generation capabilities, allowing clients to generate videos from text prompts or images.735MIT
- AlicenseAqualityDmaintenanceProvides access to Vidu's video generation models for creating high-quality videos from text, images, and reference content. It enables users to generate creative video content directly within MCP-compatible applications like Claude and Cursor.55MIT

PixVerse MCPofficial
AlicenseNot gradedqualityDmaintenanceEnables video generation from text, images, and more through MCP-compatible apps like Claude and Cursor.55MIT- AlicenseNot gradedqualityDmaintenanceExposes video generation and editing tools to MCP-capable clients, enabling text-to-video, image-to-video, video editing, reusable voice and character profiles, and task status queries through natural language.4MIT