Claude Code

Prerequisites

• Node.js 18+
• Claude Code installed

Step 1: Install TaskFlow MCP Server

1npm install -g @dalmasonto/taskflow-mcp

Step 2: Configure MCP Server

Create a .mcp.json file in your project root (per-project) or ~/.mcp.json (global):

1{
2  "mcpServers": {
3    "taskflow": {
4      "command": "taskflow-mcp",
5      "args": []
6    }
7  }
8}

Claude Code auto-detects .mcp.json files and starts the MCP server automatically.

Step 3: Grant Permissions

Add TaskFlow tools to your allow list in ~/.claude/settings.json or .claude/settings.local.json (per-project):

1{
2  "permissions": {
3    "allow": [
4      "mcp__taskflow__*"
5    ]
6  },
7  "enableAllProjectMcpServers": true,
8  "enabledMcpServers": [
9    "taskflow"
10  ]
11}

This auto-approves all TaskFlow MCP tools so the agent can work autonomously.

Step 4: Verify

Start Claude Code in your project:

1claude

The agent will detect the MCP server and load all 50 tools. You can verify by asking:

"What TaskFlow tools do you have available?"

CLAUDEmd Integration

Add this to your project's CLAUDE.md to ensure the agent uses TaskFlow on every conversation:

1## MCP Integration
2 
3At the start of each conversation, call the `get_agent_instructions` tool
4from the taskflow MCP server to understand your task management workflow.

Tips

• Run Claude Code inside tmux to enable live agent chat via the TaskFlow UI
• The agent calls bootstrap or get_agent_instructions on startup - it learns the full workflow automatically
• Use ask_user for questions that should appear in the Agent Inbox for remote response