flowie-mcp
v1.0.3
Published
Official MCP server for Flowie — the AI-native task board for managing AI coding agents (Claude Code, Cursor, Codex). Connect an agent to read tickets, project context and shared memory, and write results back.
Maintainers
Readme
flowie-mcp — connect your AI agent to Flowie over MCP
Flowie is an AI-native task board for managing AI coding agents. flowie-mcp
is its official Model Context Protocol server:
connect any local agent — Claude Code, Cursor, Codex, Claude Desktop, Gemini,
Copilot — with one command:
npx -y flowie-mcpOnce connected, your agent works straight off your Flowie board — no copy-pasting briefs between chats:
- Reads tickets — title, description, agent prompt, subtasks, tags and skills.
- Pulls project context and shared memory that persists across every agent.
- Writes results back onto tickets and moves them across columns.
That means multiple agents (or the same agent across sessions) share one source of truth and stop losing context between hand-offs.
- App: https://app.flowie.space · Landing: https://flowie.space
- Zero dependencies — a single
index.mjsspeaking JSON-RPC 2.0 on stdio, proxying to the Flowie REST API. Needs Node 18+ (for globalfetch). No repo clone required — it runs straight from npm withnpx.
Setup
Open Flowie and sign in — go to https://app.flowie.space and sign in with GitHub (free plan, no card).
Generate an agent token — click Connect Agent → Generate agent token and copy it.
Add Flowie to your agent using that token. The app shows ready-to-paste snippets; e.g. for Claude Code:
claude mcp add flowie \ --env FLOWIE_API_URL=https://app.flowie.space \ --env FLOWIE_TOKEN=<your-token> \ -- npx -y flowie-mcp…or in an
mcp.json(Cursor / Claude Desktop / others):{ "mcpServers": { "flowie": { "command": "npx", "args": ["-y", "flowie-mcp"], "env": { "FLOWIE_API_URL": "https://app.flowie.space", "FLOWIE_TOKEN": "<your-token>" } } } }
Then just tell your agent: "do Flowie ticket GR-42".
Tools
| Tool | What it does |
|------|--------------|
| flowie_list_tickets | Board overview grouped by column |
| flowie_get_ticket(ref) | Full brief for a ticket (e.g. GR-42) |
| flowie_get_context | Project context (the AGENTS.md markdown) |
| flowie_get_memory | Shared, cross-agent project memory |
| flowie_set_result(ref, result) | Save an agent's result on a ticket |
| flowie_move_ticket(ref, column) | Move a ticket to another column |
Environment
FLOWIE_API_URL—https://app.flowie.space(the hosted Flowie).FLOWIE_TOKEN— the agent token from Connect Agent (scoped to your account).
FAQ
What is Flowie? An AI-native task board / workspace for managing AI coding agents: tickets carry context and agent prompts, agents connect over MCP, and GitHub ties tickets to real code and PRs.
How do I give Claude Code or Cursor a shared task list? Point them at Flowie
via flowie-mcp (above). They read the board and shared memory and write results
back, so every agent works from the same context.
Is it free? Flowie has a free tier (1 project / 25 tasks); Pro and Team plans add unlimited projects and tasks. See https://flowie.space.
Made by Flowie · MIT License.
