Skip to main content
Glama
alarconcesar

flow-mcp

by alarconcesar
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Google Flow MCP šŸŽØ

Python 3.11+ MCP License: MIT

MCP server for generating images via Google Flow ā€” no daily quota limits.

Claude Code (or any MCP client) can generate images using Google Flow's batchGenerateImages API directly through a Playwright browser context with your saved authentication, bypassing the Flow Agent chat quota (~10 images/day).

Features

  • Text-to-Image ā€” generate images from text prompts

  • Image-to-Image ā€” use a reference image (pass reference_image)

  • No quota limits ā€” calls the API directly, not through the chat

  • Persistent browser pool ā€” reuses Chrome across generations (faster)

  • Auto-retry ā€” refreshes auth token if it expires

  • Progress reporting ā€” shows generation progress in Claude Code

  • No external CLI dependencies ā€” includes its own auth/login

  • Cross-platform ā€” Windows, macOS, Linux (incl. headless)

Related MCP server: Nano Banana MCP

Requirements

Dependency

Notes

Python 3.11+ (or uv)

Google Chrome or Playwright's Chromium

For authentication & generation

Xvfb (Linux headless only)

For auth login only (MCP server runs headless)

Installation

Prerequisites

  • Python 3.11+

  • Google Chrome (for authentication)

  • Playwright browsers (for generation)

Install from PyPI (recommended)

pip install flow-mcp

# Or with uv:
# uv pip install flow-mcp

# Install Playwright browsers
playwright install chromium

# Authenticate with Google Flow
flow-mcp auth login

Or install from GitHub

git clone https://github.com/alarconcesar/flow-mcp.git
cd flow-mcp
uv pip install -e .
playwright install chromium
flow-mcp auth login

Usage with Claude Code

Add to your .claude/settings.json:

{
  "mcpServers": {
    "flow-image-server": {
      "command": "uv",
      "args": ["run", "flow-mcp"]
    }
  }
}

Restart Claude Code. The generate_image tool will be available.

Parameters

Parameter

Type

Default

Description

prompt

string

required

Text description of the image

model

enum

nano-pro

nano2, nano-pro, narwhal, gem_pix_2

count

integer

1

Number of images (1ā€“4)

aspect

enum

9:16

9:16, 16:9, 1:1, 4:3, 3:4

reference_image

string

optional

Path to a local image for I2I

Examples

Text-to-Image:

Generate an image of a cyberpunk city at night, neon lights, 16:9

Image-to-Image:

Take this photo and make it cyberpunk style,
reference_image: /Users/me/photo.jpg

CLI commands

flow-mcp                    # Start MCP server (stdio mode)
flow-mcp auth login         # Authenticate with Google Flow
flow-mcp auth list          # List saved profiles
flow-mcp help               # Show help

Environment variables

Variable

Default

Description

GFLOW_PROFILE

auto-detected

Profile name

GFLOW_CLI_HOME

platform default

gflow-cli data directory

GFLOW_OUTPUT_DIR

temp directory

Where to save generated images

Troubleshooting

Auth expired

flow-mcp auth login

Content filter

Google Flow silently blocks certain prompts (returns None). Try rephrasing ā€” avoid violence, NSFW, or trademarked content.

Linux headless

# Only needed for authentication (the MCP server itself runs headless)
Xvfb :99 -screen 0 1280x720x24 &
DISPLAY=:99 flow-mcp auth login --browser internal

The MCP server (flow-mcp) now runs completely headless ā€” no Xvfb needed for generation.

Profile not found

flow-mcp auth list         # list profiles
flow-mcp auth login        # create a new profile

Project structure

flow-mcp/
ā”œā”€ā”€ src/
ā”‚   ā””ā”€ā”€ flow_mcp/
ā”‚       ā”œā”€ā”€ __init__.py      # Package metadata & logging config
ā”‚       ā”œā”€ā”€ __main__.py      # CLI entry point (auth, server)
ā”‚       ā”œā”€ā”€ server.py        # FastMCP tool definition
ā”‚       ā”œā”€ā”€ generator.py     # Core generation logic
ā”‚       ā”œā”€ā”€ browser.py       # Playwright context & token capture
ā”‚       ā”œā”€ā”€ browser_pool.py  # Persistent browser context pool
ā”‚       ā”œā”€ā”€ auth.py          # Login, profile list commands
ā”‚       ā”œā”€ā”€ profile.py       # Profile resolution
ā”‚       ā”œā”€ā”€ recaptcha.py     # reCAPTCHA token minting
ā”‚       ā”œā”€ā”€ chrome_helpers.py # Chrome detection
ā”‚       ā””ā”€ā”€ constants.py     # Shared constants
ā”œā”€ā”€ pyproject.toml
ā”œā”€ā”€ LICENSE (MIT)
ā””ā”€ā”€ README.md

License

MIT ā€” see LICENSE.

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

ā€“Maintainers
ā€“Response time
ā€“Release cycle
ā€“Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alarconcesar/flow-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server