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=date

Usage

bun run dist/index.js

MCP 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
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