← All MCP tools
Capture & grooming

Propose capture

propose_capture
Write

What it does

Propose a task for the human's capture inbox — the front door, aimed at creation the way propose_completion is aimed at completion. Use it when you notice something that probably should be a task but isn't: a commitment made in a meeting, a follow-up implied by an email, a promise in a thread. This does NOT create a task. It raises a suggestion the human accepts or dismisses with one keystroke, and accepting is what creates the task. You cannot accept your own suggestion. Give source ("calendar" today), an optional source_ref identifying the thing it came from, a title written as the task you'd want to see, and a note saying where it came from so the human can judge it without opening anything. Proposing the same source_ref twice is a no-op rather than a duplicate.

Parameters

NameTypeRequiredDescription
sourcestringRequired
Allowed valuescalendardictation
source_refstringOptional

Identifier of the originating item, e.g. a calendar_events id

  • Up to 500 characters
titlestringRequired

The proposed task title

  • Up to 500 characters
notestringOptional

Where it came from and why you think it's a task

  • Up to 10000 characters

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 tokenRefused

Try it

With Done connected, ask your assistant something like:

“From today's meeting, suggest tasks for my capture inbox.”

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 →