← All MCP tools

List workspaces

list_workspaces
Read-only

What it does

List the workspaces this account belongs to — id, name, role (owner or member), and notes_for_agent, the workspace's standing brief: instructions that apply to everything in it, the widest of the three tiers get_task resolves (workspace → project → task, most specific last). A workspace is who can see a set of tasks: most accounts have exactly one ("Personal"), and an account that works with other people has one per shared space. Use the ids with create_project to file a project into a particular workspace. Read-only — workspaces are created and shared by the human, in Account → Workspaces & team, and the brief is the human's to write; propose a change with ask_decision.

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:

“Which workspaces am I in?”

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 →