Skip to content

list_task_statuses

list_task_statuses

Return every task status configured in the authenticated user’s team, ordered by order ascending. Use this to discover valid taskStatusId values for create_task and update_task.

This tool takes no arguments.

A single text content block containing a JSON array of task status objects.

FieldTypeDescription
idnumberNumeric ID of the status.
namestringDisplay name of the status.
colorstring | nullHex color used in the UI, or null if not set.
isDefaultbooleantrue for the status applied to new tasks when none is specified.
isCompletedbooleantrue if tasks in this status are considered done.
ordernumberSort position used in the UI.
[
  { "id": 1, "name": "Backlog",     "color": "#94a3b8", "isDefault": true,  "isCompleted": false, "order": 0 },
  { "id": 2, "name": "Todo",        "color": "#64748b", "isDefault": false, "isCompleted": false, "order": 1 },
  { "id": 3, "name": "In progress", "color": "#3b82f6", "isDefault": false, "isCompleted": false, "order": 2 },
  { "id": 4, "name": "Done",        "color": "#22c55e", "isDefault": false, "isCompleted": true,  "order": 3 }
]