DevFlow MCP Server
MCP server for integrating DevFlow with AI code assistants. Enables structured development workflows with enforced planning, task tracking, and code review gates.
What is DevFlow?
DevFlow brings structure to AI-assisted development. Instead of letting AI agents write code without oversight, DevFlow enforces a workflow:
idea -> planning -> approval -> ready -> in_progress -> review -> done
Every feature or bugfix goes through planning, gets approved, is tracked with tasks, and must pass review before completion. The MCP server connects your AI coding assistant to DevFlow, making this workflow seamless.
Installation
As a Claude Code Plugin (recommended)
DevFlow is listed in the official Claude Code community marketplace. Install in one line:
/plugin marketplace add anthropics/claude-plugins-community
/plugin install devflow
This installs everything in one shot: MCP server (auto-registered via mcpServers in the plugin manifest), enforcement hooks, state-specific skills, and slash commands (/devflow-start, /devflow-status, /devflow-next, /devflow-tasks, /devflow-create, /devflow-list, /devflow-review). No separate MCP setup step needed.
Updates: /plugin update devflow.
Manual Setup (fallback)
If you'd rather skip the plugin and wire the MCP server directly:
Claude Code
npx github:KlausFreiberufler/devflow-mcp setup
Cursor
npx github:KlausFreiberufler/devflow-mcp setup --client cursor
Gemini CLI
npx github:KlausFreiberufler/devflow-mcp setup --client gemini
Windsurf
npx github:KlausFreiberufler/devflow-mcp setup --client windsurf
Restart your AI client after setup.
Getting Started
- Run
devflow_status() to check the connection
- The browser opens for authentication on first use
- Link your project — a
.devflow.json file is created in your project directory
- Start working:
flow_list() to see available flows, or flow_create() to create one
- Initialize your session:
devflow_init({ flowId: "..." })
Compatible Clients
Flow States
| State | Description |
|---|
idea | New idea, no plan yet |
planning | Agent creates implementation plan |
approval | User approves the plan (wait state) |
ready | Plan approved, ready for implementation |
in_progress | Implementation in progress |
review | User reviews the implementation (wait state) |
done | Completed |
Required Fields for State Transitions
| Transition | Required Fields |
|---|
-> approval | implementationPlan |
-> review | agentSummary, testingInstructions |
Available MCP Tools
Session & Flows
| Tool | Description |
|---|
devflow_init | Required before all other tools. Starts a flow session |
devflow_status | Show connection status, link/unlink projects |
flow_list | List flows (filtered by project) |
flow_get | Get flow details including plan and audit trail |
flow_create | Create a new flow |
flow_update | Update state, plan, agent messages |
flow_get_feedback | Get user feedback on plan or code |
Tasks
| Tool | Description |
|---|
task_list | List tasks of a flow |
task_create | Create a new task |
task_update | Update task or mark as completed |
Agent Sessions
| Tool | Description |
|---|
agent_session_create | Create agent session (tracking) |
agent_session_log | Log progress to a session |
agent_session_complete | Complete an agent session |
agent_session_list | List sessions of a flow |
Documentation & Search
| Tool | Description |
|---|
doc_page_list | List documentation pages |
doc_page_get | Get a documentation page |
doc_page_create | Create a documentation page |
doc_page_update | Update a documentation page |
project_guidelines_get | Get project guidelines |
search | Search flows, tasks, and projects |
Releases
| Tool | Description |
|---|
release_list | List releases |
release_get | Get release details |
release_create | Create a new release |
release_update | Update release status/details |
Knowledge — Wiki & ADRs (v4.5.0)