Skip to main content
Glama

Google Flow MCP

Clean MCP server for Google Flow (labs.google/fx/tools/flow) — a thin browser bridge that lets AI agents (Codex, Claude Code, Antigravity) control Google Flow directly using your Google Pro account.

No API. No third-party services. Just your browser, your account, your credits.


What It Can Do

Tool

What it does

flow_open

Navigate to Flow, or a specific project

flow_snapshot

See all UI elements and generated media on screen

flow_click

Click any button, menu item, or card

flow_type

Type a prompt into any input field

flow_upload

Upload a local file (reference image, etc.)

flow_download

Save a generated image or video to disk

flow_wait

Wait for generation to finish

flow_confirm_paid_generation

Authorize a paid Veo/Omni generation (safety guard)


Related MCP server: google-flow-mcp

Setup

1. Install & Build

cd "/Volumes/Xstorage/MCP - Googel Flow 2"
npm install
npm run build

2. Configure Environment

cp .env.example .env

Edit .env — set LOCAL_STORAGE_ROOT to wherever you want images saved.

3. One-Time Google Login

npm run login

Chrome opens. Sign into your Google account and navigate to labs.google/fx/tools/flow. Close the script with Ctrl+C when done. Your session persists forever (or until Google forces re-auth).


Platform Integration

Antigravity IDE

Add to ~/.gemini/antigravity-ide/mcp_config.json:

{
  "mcpServers": {
    "google-flow": {
      "command": "node",
      "args": ["/Volumes/Xstorage/MCP - Googel Flow 2/dist/index.js"],
      "env": {
        "LOCAL_STORAGE_ROOT": "/Volumes/Xstorage/Media",
        "HEADLESS": "false"
      }
    }
  }
}

Codex (ChatGPT Desktop)

Add to ~/.codex/config.toml:

[mcp_servers.google-flow]
command = "node"
args = ["/Volumes/Xstorage/MCP - Googel Flow 2/dist/index.js"]
startup_timeout_sec = 30

[mcp_servers.google-flow.env]
LOCAL_STORAGE_ROOT = "/Volumes/Xstorage/Media"
HEADLESS = "false"

Restart Codex to pick up.

Claude Code (Desktop App)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "google-flow": {
      "command": "node",
      "args": ["/Volumes/Xstorage/MCP - Googel Flow 2/dist/index.js"],
      "env": {
        "LOCAL_STORAGE_ROOT": "/Volumes/Xstorage/Media",
        "HEADLESS": "false"
      }
    }
  }
}

Restart Claude to pick up.


Example Agent Workflow

Tell the agent (Codex, Claude, Antigravity):

"Open Google Flow, type this prompt into the image composer: 'cinematic wide shot of ancient Greece at sunset, photorealistic', generate the image, wait for it to finish, and download it to /Volumes/Xstorage/Media"

The agent will chain:

flow_open → flow_snapshot → flow_type → flow_click → flow_wait → flow_download

For paid Veo video generation, the agent will call flow_confirm_paid_generation first and ask your approval.


Development

npm run dev        # Run without building (tsx)
npm run build      # Compile to dist/
npm run typecheck  # Type check only
npm run login      # One-time Chrome Google login

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to programmatically generate images and videos through the authenticated Google Flow web interface via a direct Chrome DevTools Protocol connection, exposing tools for media generation, project management, status checks, and asset downloads without requiring official API keys.
      2
      7
      6
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables users to generate images and videos on Google Flow through browser automation of an already signed-in Chrome session, downloading the finished media to disk without any API keys. It drives Flow's agent with a range of image and video models, plus reference images, first/last frames, and ingredient-based video jobs, while reusing the user's own Google AI Pro credits.
      17
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to automate a local background Chromium browser for interactive web tasks, including prompt generation on Google Flow (Veo & Imagen), DOM inspection, clicks, screenshots, and JavaScript evaluation.
      8
      MIT