← All MCP tools
What it does
Rename a project, change its color, set waiting (true = you're blocked on someone else; filed under "Waiting on" in the sidebar), and/or reparent it (parent_id, or null to make it a top-level project). Rejects cycles.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | |
name | string | Optional |
|
color | string | Optional |
|
waiting | boolean | Optional | |
parent_id | string | null | Optional | |
goal_id | string | null | Optional | The goal (North Star) this project works toward; null to unfile it. |
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: true - Can remove or overwrite something that's already there.
- Idempotent
idempotentHint: true - Calling it twice with the same arguments leaves the same result as calling it once.
- 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:
“Rename the Q4 project to Q4 launch and mark it as waiting.”
Connect Done to your assistant
One MCP endpoint per account, over OAuth or a token. Step-by-step setup for each client: