Tools in this category
| Tool | Mutating | Description |
|---|---|---|
list_task_types |
no | List all task types configured for the current user. Call this before setting type on a task — types are user-configured and required. Each type’s customFields array lists its user-defined custom fields ({ key, label, type, required }); use those keys in the customFields map of create_task / update_task. |
get_task_type |
no | Fetch a single task type config, including its slug, display name, color, sort order, and the standalone / embeddable flags that decide whether tasks of this type may sit at top level or be attached as subtasks. |
create_task_type |
yes | Create a new task type. typeId is the stable slug, unique per user (e.g. "bug", "research"); auto-generated from name if omitted. Set embeddable when the type is for subtasks, since it defaults to false. Use this when a needed type does not appear in list_task_types. |
update_task_type |
yes | Update a task type. Only supplied fields change. The slug is immutable. |
delete_task_type |
yes | Delete a task type. Fails if any tasks still use this type (migrate them first via update_task or bulk_update_tasks) or if it is the last enabled task type. |
list_task_types
Mutating: no
List all task types configured for the current user. Call this before setting type on a task — types are user-configured and required. Each type’s customFields array lists its user-defined custom fields ({ key, label, type, required }); use those keys in the customFields map of create_task / update_task.
Parameters
No parameters.
get_task_type
Mutating: no
Fetch a single task type config, including its slug, display name, color, sort order, and the standalone / embeddable flags that decide whether tasks of this type may sit at top level or be attached as subtasks.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Task type config ID |
create_task_type
Mutating: yes
Create a new task type. typeId is the stable slug, unique per user (e.g. "bug", "research"); auto-generated from name if omitted. Set embeddable when the type is for subtasks, since it defaults to false. Use this when a needed type does not appear in list_task_types.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
typeId |
string | no | Stable slug for the type, e.g. "bug" |
name |
string | yes | Display name |
description |
string | no | Free-form description shown in the UI tooltip. |
color |
string | no | Color token or hex |
enabled |
boolean | no | Defaults to true |
billable |
boolean | no | User-facing label on the type (default false). Stored and shown in settings; it does not filter queries or affect invoicing. |
order |
number | no | Sort order (default 0) |
standalone |
boolean | no | Whether tasks of this type may sit at top level (default true). Set false for a subtask-only type; a parentless task using it is then rejected. |
embeddable |
boolean | no | Whether tasks of this type may be attached as a subtask (default false). A subtask whose type is not embeddable is rejected. |
allProjects |
boolean | no | When true (default), the type is available for tasks in any project. Set false to restrict it to scopedProjectIds. |
scopedProjectIds |
array | no | Projects the type is limited to (used only when allProjects is false) — each accepts a UUID or display ID (e.g. "P-7"). |
update_task_type
Mutating: yes
Update a task type. Only supplied fields change. The slug is immutable.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Task type config ID |
name |
string | no | Display name. |
description |
string | no | Free-form description. |
color |
string | no | Color token or hex. |
enabled |
boolean | no | Whether the type is selectable in pickers. |
billable |
boolean | no | User-facing label on the type. Stored and shown in settings; it does not filter queries or affect invoicing. |
order |
number | no | Sort order. |
standalone |
boolean | no | Whether tasks of this type may sit at top level (default true). Set false for a subtask-only type; a parentless task using it is then rejected. |
embeddable |
boolean | no | Whether tasks of this type may be attached as a subtask (default false). A subtask whose type is not embeddable is rejected. |
allProjects |
boolean | no | When true (default), the type is available for tasks in any project. Set false to restrict it to scopedProjectIds. |
scopedProjectIds |
array | no | Projects the type is limited to (used only when allProjects is false) — each accepts a UUID or display ID (e.g. "P-7"). |
delete_task_type
Mutating: yes
Delete a task type. Fails if any tasks still use this type (migrate them first via update_task or bulk_update_tasks) or if it is the last enabled task type.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Task type config ID |