taskwarrior-mcp
v2.2.1
Published
MCP server for Taskwarrior — list, create, update, complete, and manage tasks via the Model Context Protocol
Maintainers
Readme
task-mcp
MCP server for Taskwarrior with agent claim/lease semantics.
Setup
Required Taskwarrior Configuration
Add the following to your ~/.taskrc to enable claim metadata:
uda.owner_agent.type=string
uda.lease_until.type=date
uda.claimed_at.type=date
uda.last_renewed_at.type=dateUsage
bun run dist/index.jsMCP Tools
| Tool | Description |
| --------------- | -------------------------------------------------- |
| project_list | List all projects |
| list_tasks | List tasks (returns claim metadata) |
| claim_task | Claim a task for an agent |
| release_task | Release a claim |
| create_task | Create a new task (returns task payload with uuid) |
| update_task | Update task (requires claim) |
| complete_task | Complete task (requires claim) |
Claim Rules
- Agents must claim a task before mutating it
- Same agent can renew their claim
- Different agent cannot steal an active lease
- Expired leases are treated as unclaimed
Development
bun install
bun run dev
bun run test