What it does
Claim a task: mark it in_progress, assign it to the AI agent, and post a comment so the human sees you started. Call the moment you pick up a task. Pass agent when running in a fleet — the claim takes a 30-minute lease and this call fails if another agent already holds an active lease on the task, so two agents never work the same one. Re-claiming with your own agent id (or after the lease lapses) succeeds. Release it with release_task if you stop before finishing. The task comes back with url, its link in the Done app: when you tell the human you've started, give them that link, not the id.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | |
note | string | Optional | First message posted to the activity feed
|
agent | string | Optional | Your agent id when running as part of a fleet (defaults to a shared claim) |
Annotations
The hints the server sends with this tool. A host reads them to decide whether to ask you before a call.
- Read-only
readOnlyHint: false - Changes data in your Done account.
- Destructive
destructiveHint: false - Only adds or reads; nothing already there is removed or overwritten.
- Idempotent
idempotentHint: false - Each call can add something new, such as a comment, a run or a task.
- Open world
openWorldHint: false - Touches only your own Done account.
Which tokens can call it
A connection made with OAuth has full access. A token from Settings → Agent access → Extra MCP tokens can be narrowed, and a narrowed token never sees beyond its project or workspace.
- Full accessAllowed
- Read-only tokenRefused
- Single-project tokenRefused
- Single-workspace tokenAllowed
Try it
With Done connected, ask your assistant something like:
“Pick up the invoice reminder task and let me know you're on it.”
Connect Done to your assistant
One MCP endpoint per account, over OAuth or a token. Step-by-step setup for each client: