SkillAgentSearch skills...

flow-mcp

Drive Google Flow from Claude, Codex or a local control panel, on Mac or Windows — using your Google AI subscription credits instead of the pay-per-use video API. No browser extension.

Install / Use

claude mcp add GTAI-1 -- npx -y github:GTAI-1/flow-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

92/100

Supported Platforms

Claude Code
Claude Desktop
OpenAI Codex

Tags

Our assessment of flow-mcp

flow-mcp scores 92/100 on our quality scale, 791st of 4,698 Development & Engineering skills we index (top 17%).

Its MCP Server is 16 KB long, well organised into 13 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.

It has 656 GitHub stars, a meaningful sign that others use it.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated yesterday, so flow-mcp is actively maintained.
  • Our last check on 2026-11-09 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-09. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

flow-mcp compared with similar skills

All 4 of these similar skills score higher than flow-mcp; compare them before choosing.

SkillScoreStarsUpdatedFormat
flow-mcp (this skill)by GTAI-1926561d agoMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install flow-mcp?
Run claude mcp add GTAI-1 -- npx -y github:GTAI-1/flow-mcp. The install tabs above show the steps for each supported agent.
Which AI agents does flow-mcp work with?
It is written for Claude Code, Claude Desktop and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
Is flow-mcp safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is flow-mcp still maintained?
The repository was last updated yesterday, so flow-mcp is actively maintained.

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 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 | | whisper.cpp (optional, free) | Only for captions: it hears the words, on your computer. Mac: brew install whisper-cpp · Windows: whisper-cli.exe from the whisper.cpp releases, on your PATH. The speech model it needs downloads by itself the first time you caption a video: 148 MB for English, 574 MB for any other language |

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):

[mcp_servers.flow]
command = "node"
args = ["/absolute/path/to/flow-mcp/dist/index.js"]

Or run codex mcp add flow -- node /absolute/path/to/flow-mcp/dist/index.js. No timeout setting is needed: Codex, like most MCP apps, gives up on a tool call after 60 seconds, so any call that runs longer than about 45 seconds (creating a character, a 1080p download) answers with a task id instead and keeps working, and flow_wait collects the result.

Antigravity (Google's coding app): add a flow entry to mcp_config.json. On a Mac it lives in ~/.gemini/antigravity/; you can also open it from the agent panel's … menu → Manage MCP Servers → View raw config. Keep any servers already listed and add this one beside them:

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

Other MCP apps (Cursor, VS Code and others) take the same command and arguments in their own MCP settings. ChatGPT in the browser or the ChatGPT app can't use it: its connectors only reach servers on the internet, and this tool has to run on your own computer to drive your Chrome window.

Developed and tested with Claude. Codex and Antigravity speak the same protocol, so they should work the same way, but neither has been tried yet, so please report how it goes. Running two of them at once is safe: the first one started drives Flow, and the others pass their requests to it.

Restart the app, then ask it: "check my Flow session". You should get your plan and credit balance back. Everything after that is plain English; you never type tool names.


Your first film

Nothing below costs a credit until step 4, and the assistant asks before spending.

  1. Check the session. "Check my Flow session." This confirms sign-in, plan and credits.
  2. Make a character. "Create a character called Pip, a small lamplighter in a flat cartoon style." Flow draws the portrait. Free.
  3. Draw the key frames. "Draw three stills with Pip: a dark rooftop, him lighting a lamp, the whole hillside glowing. Match each one to the last." Free: stills cost nothing, so get the look right here before spending.
  4. Shoot it. "Turn those into three 10-second shots, each starting where the last one ended, 720p, no more than 15 credits each." This spends credits. The price is read from Flow's own quote first and the scene is skipped if it is over your cap.
  5. Narrate it. "Record this line with a warm documentary voice." Free, any length.
  6. Cut it. "Join the three shots under the narration, don't freeze the last frame." The finished file lands in ~/flow-mcp-out/<project>/.

The control panel

The same features, without an AI assistant in the loop:

npm run studio     # then open http://127.0.0.1:8787

or double-click Flow Studio.command (Mac) or Flow Studio.cmd (Windows).

Eight tabs, in the order you would use them:

  • Cast: reusable characters. Create them, edit them in place, or build one from a picture.
  • Frames: free stills, with match previous frame to keep a set on-model.
  • Shots: paid clips, with first/last frames, chaining, a live credit estimate, and a card that continues a finished clip from its own last frame.
  • Voice: free narration with Kokoro (the default: 28 voices, runs on your computer, no key) or Google's voices. Your saved narrations are listed here to play or delete, and there's a field for your Google AI Studio key (checked with Google, stored only on your computer; never paste it into a chat).
  • Restyle: change a clip you already have.
  • Cut: join any videos into one film, in the order you pick. Upload one, or choose from films you've already made. Add a narration (from your saved ones or an upload) and music, and turn the clips' own sound down so the narration sits on top.
  • Captions: put the spoken words on screen, the way short-form videos do, on wide or vertical videos. Pick a video and the language spoken in it (about 100 languages, or Detect automatically), choose a style (Bold pop, Highlight, Word by word, Clean, Boxed), where it sits (bottom, middle, top, an exact height, or tap the preview), its size (a slider), its letters (normal, CAPS or lowercase) and highlight colour, and see it on a real frame of your video before anything is made. Fix any misheard word in the text box and it keeps its timing; press Enter to start a new caption. Saves <name>-captions.mp4 plus an .srt for YouTube. Everything happens on your computer; nothing is uploaded.
  • Library: everything in your Flow project. Download it again for free (a scene comes down as one finished film, not loose clips), or move it to Flow's Trash.

A progress monitor and a gallery of your saved work sit alongside. The gallery shows stills or clips on the tabs that use them. On a wide screen, each side scrolls on its own. Two kinds of delete, clearly labelled: Move to the Mac's Trash / Recycle Bin removes a file from your computer; Move to Flow's Trash removes it from your Flow project only. Both can be undone.

The panel ships with the repo but is not started for you: run npm run studio when you want it. Opening studio/index.html as a plain file does nothing; the page needs the server behind it, and says so in red if you try.

Claude's own process serves the same panel while it runs. Whichever process starts first owns the Chrome tab and the job queue; the other talks to it over a local API, so Claude and the panel always agree on what is running. That API listens on 127.0.0.1 only and needs a per-run token (~/.flow-mcp/token).


Tools

| Tool | Purpose | |---|---| | flow_status | Session state (signed in, project open, plan, credits left), queue, pacing, prompt playbook | | flow_generate | Queue scenes: prompt, image or video, model, aspect, duration, resolution, variants, first/last frame, reference images, max_credits cap | | flow_wait | Wait for jobs, or for the task id of a slow call; returns file paths and results. Answers within about 40 s, so call again until finished is true | | flow_cancel | Cancel a job that has not started | | flow_retry | Re-queue failed jobs with the same settings and file names (a failed tile is first retried inside Flow with its own free Retry button: retries, default 1) | | flow_assets | List images and videos already in the Flow project (usable as asset:<title>) | | flow_download | Download existing project media without regenerating. Free, including the 1080p / 2K upscale. A scene comes down as one stitched film | | flow_trash | Move an image, video or scene in the Flow project to Flow's Trash, where it can be restored. Exact title only; refuses if two items share it; never deletes permanently | | flow_agent_images | Fast image batch: hands up to 50 scenes to Flow's own Agent mode, rendered in parallel (20 images in ~204 s), 0 credits. Each image is matched back to its scene by its stored prompt, so file numbers are right in any finish order. Scenes the agent drops are re-asked of it (up to 2 rounds), then re-run one by one. references attaches characters, places and objects once in the agent's composer (like its + button), and scene_references says which scenes use which, so a whole story stays on-model; scenes made one by one keep their references | | flow_edit | Video-to-video edit of a clip already in the project (relight, weather, remove objects). Flow shows no quote first; about 20 credits for a 4 s clip | | flow_continue | Start a clip from the last frame of an existing one with a character or your avatar still attached. The composer allows a start frame or attached characters, never both, so this drives Flow's agent mode, which does both. No quote beforehand | | flow_character | Create a reusable character from a description (Flow draws the portrait) or an image, with a personality and a stock voice; use it as asset:<name> | | flow_character_edit | Restyle an existing character in place (free) and save the new portrait; name, personality and voice are kept, so every scene referencing it updates. Pass `look

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars656
CategoryDevelopment
Updated1d ago
Forks236

Languages

TypeScript

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium
flow-mcp — MCP Server: Install & Safety Check | SkillAgent