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, billable flag, and sort order. |
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. 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. |
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, billable flag, and sort order.
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. 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 | Defaults to false |
order |
number | no | Sort order (default 0) |
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 | Project IDs the type is limited to (used only when allProjects is false). |
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 | Whether tracked time on this type is billable. |
order |
number | no | Sort order. |
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 | Project IDs the type is limited to (used only when allProjects is false). |
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.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Task type config ID |