flow-mcp-server
Uses ffmpeg for scene assembly, concatenating multiple generated MP4 clips into a single normalized 24 fps H.264/AAC MP4 for finished video output.
Automates Google Flow (flow.google.com) through a signed-in Chrome session to generate visual assets: creates projects, generates images with Nano Banana Pro / Nano Banana 2 / Imagen 4, generates videos with Veo 3.1 Quality / Fast / Lite and Omni Flash, lists available models and histories, checks credit balance and login state, and exports generated media through signed download URLs.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
google-flow-mcp-http
Plug-and-play, remote-ready Model Context Protocol (MCP) server for automating Google Flow (Veo 3.1 Quality / Fast / Lite, Omni Flash, Nano Banana Pro / 2, Imagen 4, and ffmpeg scene assembly) through a real Chrome session (Chrome DevTools Protocol / CDP) exposed over MCP Streamable HTTP (POST, GET, DELETE /mcp).
Designed end-to-end so remote AI agents (Hermes Agent, Claude Code, Antigravity, Cursor, or multi-agent orchestrators on another VPS) can produce visual assets using your Google Flow subscription credits safely.
End-to-End Architecture
flowchart LR
Agent["Remote AI Agent\n(Hermes / Claude / Agy)"] -->|"HTTPS + Bearer Token\nStreamable HTTP (/mcp)"| CF["Cloudflare Tunnel / Caddy\n(SSE Unbuffered)"]
CF -->|"127.0.0.1:3100"| MCP["flow-mcp-server\n(Express + Single-Job Queue\n+ Credit Guardrails)"]
MCP -->|"Internal CDP :9222\n(Auto IPv4 Resolve)"| Chrome["Real Chrome / KasmVNC\n(Signed-in Profile)"]
Chrome <-->|"UI + In-Tab tRPC\n(reCAPTCHA Compliant)"| Flow["flow.google.com\n(Veo 3.1 / Omni / Nano Banana)"]
MCP -->|"HMAC-SHA256 Signed URL\n(/media/:file?exp&sig)"| AgentRelated MCP server: google-flow-mcp
Plug-and-Play Quickstart (3 Minutes)
Option A: Headless Linux Homelab / VPS (Docker + KasmVNC + Cloudflare Tunnel)
git clone https://github.com/ridloabelian/google-flow-mcp-http.git
cd google-flow-mcp-http
# 1. Generate .env (256-bit random secrets), proxy templates, & generated-configs/mcp-client.json
./setup.sh --domain flow-mcp.yourdomain.com --tunnel-token "<CLOUDFLARE_TUNNEL_TOKEN>"
# 2. Start Chromium KasmVNC + MCP Server + Cloudflare Tunnel
make up-tunnel
# 3. Sign into Google Flow once via SSH port-forward to the KasmVNC web GUI
# Run on your laptop: ssh -L 3001:127.0.0.1:3001 user@server-ip
# Open https://localhost:3001 in your browser, sign in at flow.google.com, then close the SSH tunnel.
# 4. (Optional) Provision response_body_buffering=none on Cloudflare via one API command
CF_API_TOKEN="..." CF_ZONE_ID="..." PUBLIC_BASE_URL="https://flow-mcp.yourdomain.com" make cf-provision
# 5. Verify end-to-end JSON-RPC Streamable HTTP connectivity
make testOption B: Local Bare-Metal (macOS / Linux Desktop)
git clone https://github.com/ridloabelian/google-flow-mcp-http.git
cd google-flow-mcp-http
./setup.sh --non-interactive
make install
make chrome # Sign into Google in the Chrome window that opens (one-time only)
make start # Endpoint listens at http://127.0.0.1:3100/mcpConnecting Remote Agents & Installing the Skill
Once ./setup.sh finishes, a ready-to-paste client configuration with your generated Bearer token is saved at generated-configs/mcp-client.json:
{
"mcpServers": {
"google-flow": {
"type": "http",
"url": "https://flow-mcp.yourdomain.com/mcp",
"headers": {
"Authorization": "Bearer <AUTO_GENERATED_256_BIT_TOKEN>"
}
}
}
}Install SKILL.md into your local agent runtimes (~/.hermes/skills, ~/.claude/skills, and .agent/skills):
make install-skillMakefile Command Reference
Command | Description |
| Run |
| Start the Docker stack ( |
| Start the Docker stack with the |
| Stop all running Docker containers |
| Tail live logs from |
| Probe CDP targets and automatically close crashed Chrome tabs ( |
| Run end-to-end JSON-RPC smoke tests ( |
| Copy |
| Apply |
10 Exposed MCP Tools
Tool | Description |
| Check CDP reachability, Google login state, UI credit balance, and queue metrics |
| Inspect CDP targets and clean up hung/crashed tabs ( |
| List Veo 3.1 / Omni Flash / Nano Banana models from in-tab tRPC & catalog |
| List recent server jobs with signed download URLs and active DOM media tiles |
| Open and create a new project workspace in Google Flow |
| Generate images ( |
| Generate videos ( |
| Fetch job state from disk or recover timed-out connections via |
| Concatenate multiple MP4 clips into a normalized 24 fps H.264/AAC MP4 via |
| Inspect live interactive DOM elements if the Google Flow web UI changes |
Further Documentation
License
MIT © Ridlo Abelian
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to programmatically generate images and videos through the authenticated Google Flow web interface via a direct Chrome DevTools Protocol connection, exposing tools for media generation, project management, status checks, and asset downloads without requiring official API keys.276MIT
- AlicenseAqualityBmaintenanceEnables AI agents to generate Google Flow videos and images and automate Scene Builder clip extensions through a user's own Chrome session.11264 npm10MIT
- FlicenseNot gradedqualityCmaintenanceEnables a local MCP server to control an authenticated Chrome browser for interacting with Google Search, Gemini, ChatGPT, Claude, and DeepSeek, including web search and image generation without per-provider API keys.-
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants such as Claude Code, Codex, and Cursor to generate images and videos through Google Flow using a local, already signed-in Chrome session. It runs as a local MCP endpoint so assistants can submit generation jobs, manage them, and receive results using your own Flow subscription credits.2MIT