List projects

list_projects

Read-only

What it does

List all projects (sidebar containers) with their ids, names, colors, and waiting flag (true = blocked on someone else).

Parameters

This tool takes no arguments.

Annotations

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

Read-onlyreadOnlyHint: true: Changes nothing.
DestructivedestructiveHint: false: Only adds or reads; nothing already there is removed or overwritten.
IdempotentidempotentHint: —: Doesn't apply: the tool changes nothing.
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 tokenAllowed
Single-project tokenRefused
Single-workspace tokenAllowed

Try it

With Done connected, ask your assistant something like:

“List my projects.”

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 →