← All MCP tools

Comment on task

comment_on_task
Write

What it does

Post a comment (markdown ok) to a task's thread as the AI agent — the lane a human actually reads. Deliver results and conclusions here. Post ONE dense comment per run rather than a running commentary: a play-by-play of five progress pings buries the one comment that matters. Status changes, claims and run traces are recorded for you automatically in the task's history — don't narrate them. To show progress mid-run, tick acceptance criteria with check_criterion rather than commenting.

Parameters

NameTypeRequiredDescription
idstringRequired
bodystringRequired
  • Up to 20000 characters
idempotency_keystringOptional

Optional. One key per operation: pass the same key only when retrying this exact call, so a retry after a timeout replays the first result (a key already used on a different tool is refused, and keys expire after 48 hours) instead of posting a duplicate comment.

Annotations

The hints the server sends with this tool. A host reads them to decide whether to ask you before a call.

Read-onlyreadOnlyHint: false
Changes data in your Done account.
DestructivedestructiveHint: false
Only adds or reads; nothing already there is removed or overwritten.
IdempotentidempotentHint: false
Each call can add something new, such as a comment, a run or a task.
Open worldopenWorldHint: 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 tokenAllowed
  • Single-workspace tokenAllowed

Try it

With Done connected, ask your assistant something like:

“Post what you found on the pricing research task.”

Connect Done to your assistant

One MCP endpoint per account, over OAuth or a token. Step-by-step setup for each client:

MCP setup overview →