# gflow-cli

> gflow-cli is an open-source MCP server for design and media. Drive Google Flow from an agent: batched Veo video and Imagen image generation. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://ffroliva.github.io/gflow-cli/
- **Repository:** https://github.com/ffroliva/gflow-cli
- **MCP Registry name:** io.github.ffroliva/gflow-cli
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

gflow-cli is an independent, alpha project that controls Google Flow through a real Chrome window on your own signed-in session, so an assistant can generate Veo videos and Imagen stills without anyone clicking through the web interface. The maintainer states it is not affiliated with Google and drives Flow's private API, so breakage can happen. It needs Google AI Pro or Ultra access, and every generation bills your own account.

The README says credits are spent only on Veo video generation; images and composition steps are free. Batch items are recorded locally before they are submitted, and a changed Flow interface aborts with a distinct exit code (selector drift is 23) instead of resubmitting. Extras include prompt rewriting with Google's five-component formula, reusable instruction cards, Flow Characters for a consistent face across shots, video extension past 8 seconds, and a multi-scene manifest pipeline.

The `gflow mcp setup` command writes the server entry into Claude Desktop, Cursor or VS Code, and CI enforces parity between the CLI and MCP tools.

## Features

- **Veo and Imagen:** Text-to-video, image-to-video and text-to-image from the shell or an agent.
- **Consistent characters:** A minted Flow Character keeps the same person across generations.
- **Prompt tooling:** Rewrites terse prompts and applies reusable instruction cards.
- **Fail-loud batches:** Items are logged before submit and UI drift aborts the run.
- **Paced submissions:** Configurable jitter between prompts to avoid rate limits.
- **One-command setup:** gflow mcp setup registers the server with major clients.

## Good for

- Batch-generate images from a prompt list
- Create short videos with a consistent character
- Chain a still into a Veo clip
- Direct a multi-scene sequence from one manifest

## Install

### Claude Code (Terminal)

```sh
claude mcp add gflow-cli -- uvx gflow-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gflow-cli": {
      "command": "uvx",
      "args": [
        "gflow-cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gflow-cli": {
      "command": "uvx",
      "args": [
        "gflow-cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gflow-cli": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gflow-cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gflow-cli": {
      "command": "uvx",
      "args": [
        "gflow-cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gflow-cli": {
      "command": "uvx",
      "args": [
        "gflow-cli"
      ]
    }
  }
}
```

## FAQ

### Is it official?

No. It is independent, alpha and not affiliated with Google.

### What does it need?

A Google account with Flow access (AI Pro or Ultra) and a Chromium browser installed by Playwright.

### Does it cost credits?

Only Veo video generation spends credits, billed to your own account.

### Is my account at risk?

The README says it is your own account risk; automation is subject to Google's terms.

### Is gflow-cli free?

Yes. gflow-cli is open source, so you can use and self-host it for free.

### How do I add gflow-cli to Claude Code?

Run this command in your terminal: claude mcp add gflow-cli -- uvx gflow-cli

### What are the best alternatives to gflow-cli?

The closest alternatives to gflow-cli are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/gflow-cli
