Tools in this category
| Tool | Mutating | Description |
|---|---|---|
list_project_statuses |
no | List all available project statuses for the current user. Call this before creating or updating projects to get valid statusId values. |
list_task_statuses |
no | List all available task statuses for the current user. Call this before creating or updating tasks to get valid statusId values. |
create_task_status |
yes | Create a new task status. The slug is auto-generated from name if omitted. |
update_task_status |
yes | Update a task status config. Only supplied fields change; the slug is immutable. |
delete_task_status |
yes | Delete a task status. Fails if any task still uses it — reassign those first. |
create_project_status |
yes | Create a new project status. The slug is auto-generated from name if omitted. |
update_project_status |
yes | Update a project status config. Only supplied fields change; the slug is immutable. |
delete_project_status |
yes | Delete a project status. Fails if any project still uses it — reassign those first. |
create_invoice_status |
yes | Create a new invoice status. The slug is auto-generated from name if omitted. |
update_invoice_status |
yes | Update an invoice status config. Only supplied fields change; the slug is immutable. |
delete_invoice_status |
yes | Delete an invoice status. Fails if any invoice still uses it — reassign those first. |
list_project_statuses
Mutating: no
List all available project statuses for the current user. Call this before creating or updating projects to get valid statusId values.
Parameters
No parameters.
list_task_statuses
Mutating: no
List all available task statuses for the current user. Call this before creating or updating tasks to get valid statusId values.
Parameters
No parameters.
create_task_status
Mutating: yes
Create a new task status. The slug is auto-generated from name if omitted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
statusId |
string | no | Stable slug (e.g. "in-progress"). Auto-generated from name if omitted. |
name |
string | yes | Display name |
description |
string | no | Free-form description shown in pickers and tooltips. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the status is selectable in pickers; defaults to true. |
finished |
boolean | no | Treated as a "done" state — hidden by default. Mutually exclusive with backlog: a status is terminal or queued, never both, and setting both is rejected. |
backlog |
boolean | no | Treated as a backlog state — hidden from the active board. Mutually exclusive with finished: a status is queued or terminal, never both, and setting both is rejected. |
allProjects |
boolean | no | When true (default), the status is available for tasks in any project. Set false to restrict it to scopedProjectIds. |
scopedProjectIds |
array | no | Projects the status is limited to (used only when allProjects is false) — each accepts a UUID or display ID (e.g. "P-7"). |
update_task_status
Mutating: yes
Update a task status config. Only supplied fields change; the slug is immutable.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | task status config ID |
statusId |
string | no | Stable slug (e.g. "in-progress"). Auto-generated from name if omitted. |
name |
string | no | Display name |
description |
string | no | Free-form description shown in pickers and tooltips. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the status is selectable in pickers; defaults to true. |
finished |
boolean | no | Treated as a "done" state — hidden by default. Mutually exclusive with backlog: a status is terminal or queued, never both, and setting both is rejected. |
backlog |
boolean | no | Treated as a backlog state — hidden from the active board. Mutually exclusive with finished: a status is queued or terminal, never both, and setting both is rejected. |
allProjects |
boolean | no | When true (default), the status is available for tasks in any project. Set false to restrict it to scopedProjectIds. |
scopedProjectIds |
array | no | Projects the status is limited to (used only when allProjects is false) — each accepts a UUID or display ID (e.g. "P-7"). |
delete_task_status
Mutating: yes
Delete a task status. Fails if any task still uses it — reassign those first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | task status config ID |
create_project_status
Mutating: yes
Create a new project status. The slug is auto-generated from name if omitted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
statusId |
string | no | Stable slug (e.g. "in-progress"). Auto-generated from name if omitted. |
name |
string | yes | Display name |
description |
string | no | Free-form description shown in pickers and tooltips. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the status is selectable in pickers; defaults to true. |
finished |
boolean | no | Treated as a "done" state — hidden by default. Mutually exclusive with backlog: a status is terminal or queued, never both, and setting both is rejected. |
backlog |
boolean | no | Treated as a backlog state — hidden from the active board. Mutually exclusive with finished: a status is queued or terminal, never both, and setting both is rejected. |
update_project_status
Mutating: yes
Update a project status config. Only supplied fields change; the slug is immutable.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | project status config ID |
statusId |
string | no | Stable slug (e.g. "in-progress"). Auto-generated from name if omitted. |
name |
string | no | Display name |
description |
string | no | Free-form description shown in pickers and tooltips. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the status is selectable in pickers; defaults to true. |
finished |
boolean | no | Treated as a "done" state — hidden by default. Mutually exclusive with backlog: a status is terminal or queued, never both, and setting both is rejected. |
backlog |
boolean | no | Treated as a backlog state — hidden from the active board. Mutually exclusive with finished: a status is queued or terminal, never both, and setting both is rejected. |
delete_project_status
Mutating: yes
Delete a project status. Fails if any project still uses it — reassign those first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | project status config ID |
create_invoice_status
Mutating: yes
Create a new invoice status. The slug is auto-generated from name if omitted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
statusId |
string | no | Stable slug (e.g. "in-progress"). Auto-generated from name if omitted. |
name |
string | yes | Display name |
description |
string | no | Free-form description shown in pickers and tooltips. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the status is selectable in pickers; defaults to true. |
finished |
boolean | no | Treated as settled (paid) — an invoice in this status drops out of overdue checks and alerts. |
update_invoice_status
Mutating: yes
Update an invoice status config. Only supplied fields change; the slug is immutable.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | invoice status config ID |
statusId |
string | no | Stable slug (e.g. "in-progress"). Auto-generated from name if omitted. |
name |
string | no | Display name |
description |
string | no | Free-form description shown in pickers and tooltips. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Whether the status is selectable in pickers; defaults to true. |
finished |
boolean | no | Treated as settled (paid) — an invoice in this status drops out of overdue checks and alerts. |
delete_invoice_status
Mutating: yes
Delete an invoice status. Fails if any invoice still uses it — reassign those first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | invoice status config ID |