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. slug 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 entities still use it — migrate first. |
create_project_status |
yes | Create a new project status. slug 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 entities still use it — migrate 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. slug 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 — tasks here are hidden by default |
backlog |
boolean | no | Treated as a backlog state — hidden from the active board |
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 | Project IDs the status is limited to (used only when allProjects is false). |
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 — tasks here are hidden by default |
backlog |
boolean | no | Treated as a backlog state — hidden from the active board |
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 | Project IDs the status is limited to (used only when allProjects is false). |
delete_task_status
Mutating: yes
Delete a task status. Fails if entities still use it — migrate first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | task status config ID |
create_project_status
Mutating: yes
Create a new project status. slug 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 — tasks here are hidden by default |
backlog |
boolean | no | Treated as a backlog state — hidden from the active board |
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 — tasks here are hidden by default |
backlog |
boolean | no | Treated as a backlog state — hidden from the active board |
delete_project_status
Mutating: yes
Delete a project status. Fails if entities still use it — migrate first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | project status config ID |