Flo Plugin for Claude

The official Flomenco plugin for Claude. Brings Flo's AI-powered media automation directly into Claude Code via slash commands, and connects Claude Desktop to the Flo platform via MCP.

---

Quick start

1. Get your OAuth client ID

Sign in to floapp.co, go to Settings → API, and copy your OAuth client ID.

2. Add it to your shell profile

# ~/.zshrc or ~/.bashrc
export FLO_OAUTH_CLIENT_ID=<your-client-id>

Reload your shell:

source ~/.zshrc

3. Install the plugin

claude plugin install Flomenco-Inc/flo-plugin

4. Authenticate

Ask Claude to run flo_auth_login — it opens a browser window, completes the OAuth flow, and caches your token locally. You only need to do this once (or when your token expires).

---

Commands

Command	Description
/flo-qc	QC a media asset — logo consistency, spec compliance, timecode issues
/flo-moderate	Content moderation against a target rating and platform
/flo-deliver	Validate a media asset against platform delivery specs
/flo-search	Search for assets in your Flo library
/flo-query	Filename-first asset lookup
/flo-analyze	Analyze a media asset directly
/flo-config	Show current auth and config status

---

MCP tools

The plugin also exposes lower-level MCP tools for use in any MCP-capable client (Claude Desktop, Claude Code, etc.):

Tool	Description
flo_auth_login	Start OAuth login (browser PKCE flow)
flo_auth_status	Show current auth state and token info
flo_auth_logout	Clear cached token
flo_auth_setup_help	Show where to find your client ID
flo_search	Search the Flo asset library
flo_query	Filename-first asset lookup
flo_analyze	Analyze a media asset
flo_qc_logo	Run logo QC against a reference asset
flo_skill_routing	List available actions for an asset
flo_plugin_healthcheck	Check auth and connectivity
flo_happy_path_run	End-to-end validation in one call
flo_command	Run a raw /flo:* command (escape hatch)

---

Claude Desktop installation

Run the install script (requires AWS credentials with Cognito read access):

npx @flomenco/claude-plugin-mcp install:claude-desktop

Or clone the repo and run:

node tools/install-claude-desktop.js

Then fully quit and relaunch Claude Desktop.

---

Troubleshooting

flo_auth_login fails with "Invalid URL" Your FLO_OAUTH_CLIENT_ID env var is not set. Go to floapp.co/settings/api to get your client ID, add export FLO_OAUTH_CLIENT_ID=<id> to your shell profile, reload, and reinstall the plugin.

flo_plugin_healthcheck returns unreachable Check that you have network access to plugin.floapp.co. If you're on a VPN, try disconnecting.

Commands not appearing after install Restart Claude Code, or run /reload-plugins.

Token expired Ask Claude to run flo_auth_logout followed by flo_auth_login.

---

Contributing

See CONTRIBUTING.md for how to add new tools or commands.

License

MIT — see LICENSE.