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

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