flow-mcp

Drive Google Flow (flow.google.com) from Claude, Codex or any other MCP app, or from a local control panel, using Flow's own credits (free with any Google account: 50 a day), not the pay-per-use video API.

It is a small program that runs on your own machine. It opens its own Chrome window, signs in as you, and clicks Flow's real buttons. There is no browser extension, no hosted service and no account to create.

Claude / Codex ──stdio──> flow-mcp ──Chrome DevTools Protocol──> Chrome (its own profile) ──> Flow

MCP = Model Context Protocol, the standard that lets Claude use outside tools. New here? GETTING-STARTED.md takes you from nothing to your first video, step by step, and OVERVIEW.md explains what it does in plain English, with no code names.

---

What you need

macOS or Windows 10/11	Developed and tested on macOS. Windows is supported (Chrome, the computer's own voices, the Recycle Bin and the panel launcher all have Windows versions), but it hasn't been run on a real PC yet, so please report anything that breaks
Node.js 22 or newer	node --version
Google Chrome	Any recent version
A Google account	Free. Flow gives every account 50 credits a day; a paid Google AI plan adds more and unlocks 1080p downloads. Developed on a Pro plan
FFmpeg (optional)	Mac: brew install ffmpeg · Windows: winget install Gyan.FFmpeg. Needed only to join clips, mix music or record narration
A Google AI Studio key (optional, free)	Only for the Google narration voices. See below

A display must stay awake: the Chrome window is really being driven, so the machine cannot be headless or asleep mid-run.

---

Install

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

Mac: do not put this folder in ~/Desktop, ~/Documents or ~/Downloads. macOS protects those folders, and apps that launch the server from there can be refused permission to read its own files (EPERM: operation not permitted). ~/flow-mcp or anywhere in your home folder is fine.

Windows: keep it out of folders OneDrive syncs (often Desktop and Documents), where files can be held online-only. C:\Users\<you>\flow-mcp is fine.

Then sign in, once:

npm run login

That opens the dedicated Chrome window. Sign into Google by hand, open (or create) a Flow project, and leave the window open. The program never types your password; it only uses the session you created. That Chrome profile lives in ~/.flow-mcp/chrome-profile and is separate from your everyday browser.

---

Connect it to Claude, Codex or Antigravity

Claude Code

claude mcp add --scope user flow -- node /absolute/path/to/flow-mcp/dist/index.js

--scope user makes it available in every folder; the default (local) only works in the folder you ran it from.

Claude Desktop: add to claude_desktop_config.json (Mac: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\). On Windows, write the path with doubled backslashes, like "C:\\Users\\you\\flow-mcp\\dist\\index.js":

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

Codex: add to ~/.codex/config.toml (on Windows, %USERPROFILE%\.codex\config.toml):