Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@task-mcplist my tasks and claim the one about fixing the login bug"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| List all projects |
| List tasks (returns claim metadata) |
| Claim a task for an agent |
| Release a claim |
| Create a new task |
| Update task (requires claim) |
| 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 testResources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.