DevFlow MCP Server

Model Context Protocol (MCP) server for DevFlow task management.

Setup

The MCP server must be run with tsx (TypeScript executor) to avoid ESM module resolution issues.

Claude Desktop / Claude Code

1. Copy the config from examples/claude-mcp-config.json
2. Add it to your Claude MCP config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

Example:

{
  "mcpServers": {
    "devflow": {
      "command": "npx",
      "args": ["tsx", "/Users/YOUR_USERNAME/devflow-mcp/packages/mcp-server/src/index.ts"],
      "env": {
        "DEVFLOW_DB_PATH": "/Users/YOUR_USERNAME/.devflow/devflow.db",
        "MCP_AGENT_NAME": "claude"
      }
    }
  }
}

Cursor / Windsurf

1. Copy the config from examples/cursor-mcp-config.json or examples/windsurf-mcp-config.json
2. Add it to .cursor/mcp.json or your Windsurf config

Important: Use npx tsx with the source .ts file, not node with the compiled .js file.

Available Tools

• list_projects - List all projects
• get_project_context - Get full project context with planning doc and tasks
• get_planning_doc - Get only the planning document for a project
• create_task - Create a new task
• update_task_status - Update task status (todo, in-progress, completed)
• claim_task - Claim a task for an agent
• complete_task - Mark a task as completed
• add_task_note - Add a progress note to a task
• get_available_tasks - Get unclaimed TODO tasks

Usage Example

Once configured, you can interact with DevFlow through natural language:

"List all projects"
"Get context for project XYZ"
"Create a new task in project ABC"
"Claim and complete the first available task"