Propose grooming

propose_grooming

Write

What it does

Propose a batch of grooming dispositions in one reviewable pass — the disposition half of list_stale_tasks. Give a one-line summary and one item per task: disposition ("wont_do" | "defer" | "decompose" | "keep"), a reason, and for a defer a resurface_date. Every item needs a reason; an unexplained recommendation isn't reviewable. This writes NOTHING to any task — it records recommendations, and each one stays inert until a human approves that item in the app, which is the write. You cannot approve your own proposal, and neither can any other agent. Prefer one batch over calling ask_decision per stale task: ask_decision allows one open blocking question per task, so a sweep that way opens fourteen separate asks.

Parameters

Name	Type	Required	Description
`summary`	`string`	Required	One line describing the sweep, e.g. "14 tasks quiet for 30+ days"
`items`	`object[]`	Required	1 to 100 items
`items[].task_id`	`string`	Required
`items[].disposition`	`string`	Required	Allowed values`wont_dodeferdecomposekeep`
`items[].reason`	`string`	Required	Why — this is what the human reviews
`items[].resurface_date`	`string`	Optional	YYYY-MM-DD; required when disposition is "defer"

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 tokenRefused
Single-workspace tokenAllowed

Try it

With Done connected, ask your assistant something like:

“Go through the stale tasks and propose what to do with each one.”

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 →