› gflow-cli ★ Star on GitHub

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.

$ 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.

  1. 01
    gflow mcp run
    Claude / Cursor / Copilot connects over MCP.
  2. 02
    Ask in plain language
    The agent picks the Veo/Imagen model, aspect, and prompt tooling.
  3. 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.

--ui-mode

Fail fast, before credits

Aborts up front when Flow's UI cohort isn't what the command needs — instead of burning a generation.

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 →