VEO 3.1 MCP Server

Professional-grade MCP server for Google VEO 3.1 video generation with async job pattern, API key rotation, and multi-fallback download.

Quick Install

pip install veo-mcp-server
# or
uvx veo-mcp-server --help

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "veo": {
      "command": "uvx",
      "args": ["veo-mcp-server"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

What It Does

Generates AI videos using Google's VEO 3.1 model. Supports text-to-video, image-to-video, video extension, and frame interpolation. Uses an async job pattern where generation starts immediately in the background and returns a job ID for polling.

Tools (9)

Configuration

Architecture

• Async Job Pattern: All generation tools return a job ID instantly. Background threads handle the long-running Google API calls, so each MCP call returns in under 5 seconds.
• API Key Rotation: On 429/RESOURCE_EXHAUSTED, automatically switches to the backup key and retries.
• 3-Layer Download Fallback: SDK download -> URI fallback -> Wait-for-ACTIVE state. Handles Google's Files API edge cases.
• Preventive Cleanup: Deletes stuck PROCESSING files before each generation to prevent cascading 500 errors.

Models

License

MIT