waiter-mcp

MCP server for task queue management. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and other MCP-compatible agents.

Features

• Task Queue: Add tasks with type, scope, priority, and notes
• Native MCP Tools: queue_add, queue_show, queue_start_next, queue_complete, queue_achievements
• Persistent Storage: Tasks saved to ~/.waiter/queue.json
• Achievements: Track your planning progress

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "waiter": {
      "command": "npx",
      "args": ["-y", "waiter-mcp"]
    }
  }
}

Claude Code

claude mcp add waiter npx -y waiter-mcp

Cursor / Windsurf

Add to MCP settings:

{
  "mcpServers": {
    "waiter": {
      "command": "npx",
      "args": ["-y", "waiter-mcp"]
    }
  }
}

Local Development

git clone https://github.com/yourname/waiter-mcp.git
cd waiter-mcp
npm install
npm run build
npm start

Tools

| Tool | Description | |------|-------------| | queue_add | Add a new task to the queue | | queue_show | View all queued tasks | | queue_start_next | Start the next pending task | | queue_complete | Mark a task as completed | | queue_achievements | Show unlocked achievements |

Task Types

• feature - New functionality
• bugfix - Fix an issue
• refactor - Improve code without changing behavior
• docs - Documentation updates
• test - Testing improvements
• other - Miscellaneous

Task Scope

• quick - Less than 30 minutes
• medium - 1-2 hours
• large - Half a day or more
• epic - Multiple days

Task Priority

• critical - Drop everything, do now
• high - Should be done soon
• medium - Normal priority
• low - Can wait

Task Status Flow

pending -> in-progress -> completed

Achievements

| Achievement | How to unlock | |-------------|---------------| | [1st] First Task | Complete your first context session | | [PLAN] Planner | Queue 3+ tasks | | [FAST] Speed Demon | Complete session in < 2 minutes | | [DET] Detail Oriented | Answer all optional questions | | [WIN] Task Master | Complete 10 tasks |

Configuration

Set custom queue path:

export WAITER_QUEUE_PATH=/path/to/queue.json

License

MIT