get_task_list

get_task_list

Return the detail of a single task list. The authenticated user must be a member of the list. Archived lists they belong to are returned here even though list_task_lists hides them.

Input

Field	Type	Required	Description
listId	number	yes	Numeric ID of the list to fetch.

Example call

{
  "listId": 27
}

Output

A single text content block containing a JSON object describing the list.

Field	Type	Description
id	number	Numeric ID of the list.
name	string	Display name of the list.
color	string	Color tag of the list.
isArchived	boolean	true if archived.
createdAt	string	ISO 8601 timestamp the list was created.
updatedAt	string	ISO 8601 timestamp of the last update.

Example output

{
  "id": 27,
  "name": "Q3 launch",
  "color": "Blue",
  "isArchived": false,
  "createdAt": "2026-04-12T09:18:33.000Z",
  "updatedAt": "2026-05-08T11:02:08.000Z"
}

Errors

The tool returns isError: true with an explanatory text block when the list ID doesn’t exist or the authenticated user is not a member of the list.