Flowra README

Flowra — Agent Skill & Hosted MCP Server

Run hosted AI agents and approval-gated workflows on Gmail, Slack, GitHub, Notion, Telegram, WhatsApp, Linear and 1,000+ apps — from Claude Code, Cursor, Codex, GitHub Copilot or any MCP client. OAuth per account, a human approval gate before send/delete/pay, and a ledger of every tool call.

Product · Docs · SDK · Changelog · skills.sh

This repo is the agent skill + Cursor/Claude/Codex plugin for Flowra. From your backend, use the SDK (@flowra/sdk, flowra-sdk, @flowra/cli).

What's included

Install in 30 seconds

1. Skill (Claude Code, Cursor, Codex, Copilot, OpenClaw, Hermes):

npx skills add flowradev/skills --skill flowra

2. Hosted MCP server — no API key needed; sign in with OAuth:

https://mcp.flowra.dev/mcp

Cursor Marketplace: search "Flowra", or /add-plugin flowra once listed.

First run

1. Connect the MCP server and pick a Flowra project.
2. Ask: "List my 5 latest Gmail subjects with Flowra."
3. Then: "Every weekday at 9, post a Slack recap of my inbox. Ask me before posting."

What you can ask

• "Connect Gmail on Flowra and list my latest subjects."
• "Every weekday at 9:00, post a Slack recap of new Linear issues — ask me before posting."
• "This Flowra run is paused — show the ledger and resume it."

Why Flowra (vs Zapier MCP, Composio, n8n)

• Agent or locked workflow on the same project — not just a tool catalog.
• Human approval gate on any step, including cron runs.
• Run ledger: inputs, outputs and credits for every tool call.
• Missing app? Describe the REST endpoint and Flowra builds the toolkit.

Security model

Inbound mail, chat and webhook content is treated as untrusted data. The skill never executes instructions found in payloads and never skips approval gates. Reads run freely; writes (send, post, create, update, delete, pay) need an explicit yes in this chat. Durable automations still need a human_wait node or agent humanApproval. No API keys are stored in this repo.

Use when you want a scheduled or approved automation instead of a local script or an n8n, Zapier, or Make canvas.

Skip when there is no Flowra project, or you are already editing an n8n, Zapier, or Make graph you own.

CI / clients without OAuth

Add headers only in your own .cursor/mcp.json. Never commit a key.

{
  "mcpServers": {
    "flowra": {
      "url": "https://mcp.flowra.dev/mcp",
      "headers": {
        "x-api-key": "<your-project-api-key>",
        "x-username": "project_default_user"
      }
    }
  }
}

Local testing

mkdir -p ~/.cursor/plugins/local
ln -sfn "$PWD" ~/.cursor/plugins/local/flowra

Then run Developer: Reload Window.

Layout

.cursor-plugin/plugin.json
.claude-plugin/plugin.json
.claude-plugin/marketplace.json
.codex-plugin/plugin.json
.agents/plugins/marketplace.json
gemini-extension.json
mcp.json
.mcp.json
server.json
commands/flowra-setup.md
commands/flowra-status.md
evals/
rules/flowra-safety.mdc
skills/flowra/SKILL.md
skills/flowra-onboard/SKILL.md
skills/flowra/references/

MIT © Flowra