Google Flow MCP

A Python MCP server that gives Claude Desktop direct access to Google AI's latest image and video generation models.

Tools

Prerequisites

• Python 3.10 or newer
• uv (recommended) or pip
• A Google AI Studio API key — get one free at aistudio.google.com/apikey

Installation

# Using uv (recommended — no virtual env setup needed)
uvx google-flow-mcp

# Or install with pip
pip install google-flow-mcp

Claude Desktop Configuration

Add the following to your Claude Desktop config file:

{
  "mcpServers": {
    "google-flow": {
      "command": "uvx",
      "args": ["google-flow-mcp"],
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_AI_STUDIO_KEY"
      }
    }
  }
}

Config file locations

After editing the config, restart Claude Desktop.

Output Directory

Generated files are saved to ~/google_flow_outputs/ by default.

Override with the FLOW_OUTPUT_DIR environment variable:

"env": {
  "GOOGLE_API_KEY": "YOUR_KEY",
  "FLOW_OUTPUT_DIR": "/Users/you/Pictures/ai-outputs"
}

Usage Examples

Once connected, ask Claude naturally:

• "Generate a photo-realistic image of a neon-lit Tokyo alley at night"
• "Edit this image to remove the background and replace it with a forest"
• "Generate a video of a rocket launching from a desert at dusk with dramatic audio"
• "Create an anchor image of ocean waves, then animate it into a video"

Important Notes

• Image generation (Nano Banana Pro / Nano Banana 2) works on the free tier.
• Video generation (Veo 3.1) requires a paid Google AI API plan.
• All Veo videos are SynthID-watermarked by Google.
• Generated videos are stored on Google's servers for 2 days after creation.
• Video generation typically takes 1–4 minutes — Claude will wait automatically.

Development

git clone https://github.com/joshuadaniel-8090/google-flow-mcp
cd google-flow-mcp
pip install -e ".[dev]"
pytest -v

License

Apache 2.0 — see LICENSE.