Create project

create_project

Write

What it does

Create a project to group tasks. color is one of: violet, red, emerald, amber, blue, pink, teal, slate. Pass parent_id to nest it under another project.

Parameters

Name	Type	Required	Description
`name`	`string`	Required	Up to 120 characters
`color`	`string`	Optional	Up to 20 characters
`parent_id`	`string`	Optional
`workspace_id`	`string`	Optional	Which workspace the project belongs to — who can see it and its tasks. Get ids from list_workspaces. Omit for the human's personal workspace, which is where everything goes unless they've made another. A subproject takes its parent's workspace, so don't send both.
`goal_id`	`string`	Optional	File this project under a goal (North Star) as a way to reach it. Get ids from list_goals.
`idempotency_key`	`string`	Optional	Optional. One key per operation: pass the same key only when retrying this exact call, so a retry after a timeout replays the first result (a key already used on a different tool is refused, and keys expire after 48 hours) instead of creating a duplicate project.

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:

“Create a project called Home renovation, under Personal.”

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 →