← All MCP tools
Goals

Update goal

update_goal
WriteDestructiveIdempotent

What it does

Update a goal's title, notes, target_date, or status (active/achieved/archived).

Parameters

NameTypeRequiredDescription
idstringRequired
titlestringOptional
  • Up to 200 characters
notesstring | nullOptional
  • Up to 10000 characters
target_datestring | nullOptional

Optional ISO date (YYYY-MM-DD); null to clear

  • Format ^\d{4}-\d{2}-\d{2}$
statusstringOptional
Allowed valuesactiveachievedarchived

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: true
Can remove or overwrite something that's already there.
IdempotentidempotentHint: true
Calling it twice with the same arguments leaves the same result as calling it once.
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:

“Mark the half marathon goal as achieved.”

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 →