Unofficial · Alpha · MCP-native

Drive Google Flow from your terminal.
Or let your AI assistant drive it.

A command-line tool and MCP server for Google Flow — script Veo video and Imagen stills instead of clicking through the web UI. Point Claude, Cursor, or Copilot at it and the agent picks the models, prompt tooling, and settings for you.

claude — gflow mcp

# you, to your assistant: "make a 9:16 clip of a lighthouse in a storm, moody, slow push-in" gflow ›

$ uv tool install gflow-cli Get started → ▶ Watch the demo

The agent-native part

You describe it. The agent runs it.

gflow-cli ships an MCP server, so an AI assistant connects to it natively — no pasting docs, no copying commands back and forth. CLI-to-MCP parity is enforced in CI: anything the terminal can do, your assistant can do.

01
gflow mcp setup
One command writes the server entry into Claude Desktop, Cursor, or VS Code.
02
Ask in plain language
The agent picks the Veo/Imagen model, aspect, and prompt tooling.
03
Get files back
It runs the generation on your own Flow session and hands you the output.

What it handles for you

Built for real runs, not just a demo.

The knobs an agent (or you) leans on, plus the reliability work that keeps batch jobs and big projects from falling over.

--tool creative-director

Prompt-crafting, built in

Rewrites a terse line with Google's 5-component formula before a single credit is spent.

gflow instructions

Instruction cards

Persistent, credit-free brief cards that steer look and tone across every generation.

reuse by UUID

Reference an asset, don't re-upload

Chain a still into a video by its id — no duplicate uploads, no shuffling files.

gflow character create

The same face, shot after shot

Mint a Flow Character once and the same person carries across every generation — instead of re-rolling until the face matches.

exit 23

A broken run costs a message, not credits

Every batch item is recorded locally before it is submitted, and a drifting UI aborts with a distinct exit code instead of resubmitting into a stale state. Nothing generated, nothing spent.

nightly drift probe

It notices when Flow moves

A selector registry plus a nightly CI probe against the live UI, so breakage is caught by a scheduled run rather than by your batch job.

GFLOW_CLI_JITTER_RANGE

Configurable batch pacing

Tunable jitter between submissions so multi-prompt runs stop tripping rate limits.

movie.toml

Multi-scene pipeline

Direct a whole sequence from one manifest — chain clips, compose scenes, render.

Read this before you install

Unofficial, alpha, and honest about it.

Not affiliated with Google. gflow-cli is an independent, unofficial project. Flow, Veo, and Imagen are Google's.
Reverse-engineered & alpha. It drives Flow's private API; things break and change.
Runs a headed browser on your own Flow session. Treat it as your own account risk.
Needs Google AI Ultra or Pro with Flow access. Every generation bills your own account.

See it move

A short made entirely with it.

Watch the 100-second demo

Generated end to end through gflow-cli — YouTube Shorts.

$ uv tool install gflow-cli Read the docs →

Drive Google Flow from your terminal.Or let your AI assistant drive it.