← All MCP tools
What it does
List all tasks on the board (sorted by priority then due date). Filter by status/priority/project_id/parent_id/agent_ok or search titles with query.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
status | string | Optional | Allowed values not_startedin_progressplan_proposedneeds_inputpending_approvaldonewont_do |
priority | string | Optional | Allowed values urgentmediumlow |
project_id | string | Optional | |
parent_id | string | Optional | |
agent_ok | boolean | Optional | true = only tasks an agent may complete directly; false = only tasks that need a human approval. Omit for both. |
query | string | Optional | Case-insensitive substring match on title |
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: true - Changes nothing.
- Destructive
destructiveHint: false - Only adds or reads; nothing already there is removed or overwritten.
- Idempotent
idempotentHint: — - Doesn't apply: the tool changes nothing.
- 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 tokenAllowed
- Single-project tokenAllowed
- Single-workspace tokenAllowed
Try it
With Done connected, ask your assistant something like:
“Show me every urgent task on my board.”
Connect Done to your assistant
One MCP endpoint per account, over OAuth or a token. Step-by-step setup for each client: