MCP Flow Google (Self-Hosted)

Self-hosted Model Context Protocol (MCP) server for Google Flow (labs.google/fx/tools/flow).

Generate high-fidelity images with Nano Banana / ImageFX, generate videos with Google Veo 3.1 & Gemini Omni, upscale resolution (1K/2K/4K), and manage consistent character assets — all through your own Google account from any MCP client (Claude Code, Cursor, Windsurf, Antigravity, etc.).

Features

• 🖼️ Image Generation: Full access to Google's Nano Banana (NARWHAL) and Gemma models with custom aspect ratios.

• 🎬 Video Generation: Text-to-video & Image-to-video powered by Veo 3.1 (veo_3_1_t2v_lite) and Gemini Omni.

• 🔍 Image Upscaling: Upscale generated media to 1K, 2K, or 4K.

• 👤 Character Consistency: Create character cards and generate consistent renders across different scenes.

• 🔑 Your Account, Your Credits: Runs locally with your Google account cookies or tokens.

• ⚡ Dual Transport: Supports stdio (CLI/IDE integrations) and http transport.

• 🔄 Automatic OAuth Token Refresh: Exchanges session cookies for fresh access tokens automatically.

• 🌐 Multi-Endpoint API: Tries multiple Google Flow AI Sandbox endpoints for maximum compatibility.

• 🤖 Browser Automation Fallback: Automates the Google Flow web UI via Puppeteer when direct API calls fail.

• 📦 Batch Generation: Generate multiple images in a single call.

• 📋 Project & Tool Discovery: List your Google Flow projects and custom tools.

Related MCP server: Google Veo 3.1 MCP Server

Installation & Setup

1. Install Dependencies & Build

git clone https://github.com/molkex/mcp-flow-google.git
cd mcp-flow-google
npm install
npm run build

2. Configure Authentication

Copy .env.example to .env and add your Google cookies:

cp .env.example .env

Set GOOGLE_COOKIES to your Google session cookies (from labs.google). The server will automatically exchange these for fresh OAuth access tokens.

Integration Guides

Claude Code

Add the self-hosted MCP server to Claude Code:

claude mcp add --transport stdio google-flow -- node /absolute/path/to/mcp-flow-google/dist/index.js

Or using npx:

claude mcp add --transport stdio google-flow -- npx tsx /absolute/path/to/mcp-flow-google/src/index.ts

Cursor / Windsurf / Cline (mcpServers config)

Add to your mcpServers configuration in ~/.cursor/mcp.json or .vscode/mcp.json:

{
  "mcpServers": {
    "google-flow": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-flow-google/dist/index.js"],
      "env": {
        "GOOGLE_COOKIES": "your_google_cookies_string_here"
      }
    }
  }
}

Available MCP Tools

Example Usage Prompts

• "Generate a paper boat floating on a puddle in rain, landscape format"

• "Animate that image into a 4-second video with slow camera push"

• "Create a character named 'astro_bot' described as a cute 3D robot in a white space suit with orange visor"

• "Generate astro_bot standing on a cliff on Mars under two moons"

• "Upscale the Mars photo to 2K resolution"

• "List all my Google Flow projects"

• "Generate 4 images in one batch: a dragon, a castle, a forest, and a mountain"

Environment Variables

License

MIT