waiter-mcp

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