Reference

List tasks

The list-tasks tool, and the REST call it is generated from.

RESTGET /api/v1/tasks

MCPlist-tasks

Filters compose. status is what somebody asserted and state is the computed readiness; asking both finds where they disagree. ref_url is every task citing any of those URLs, compared normalised — the check to make before creating anything. Rows carry no body: get-task reads the whole task.

Parameters

projectquery · optional · array
Only these proj_… ids (repeat or comma-separate); omit for all of yours. One you are not a member of answers 404.
statusquery · optional · array
Filter by where the work is. Repeat or comma-separate.
kindquery · optional · array
Filter by what the node is; kind=project lists the goals. Repeat or comma-separate.
priorityquery · optional · array
Only these levels; none is the tasks nobody prioritised.
statequery · optional · array
Only these computed readiness states.
tagquery · optional · array
Tasks carrying any of these tags.
ref_urlquery · optional · array
Only tasks citing any of these URLs, compared normalised. Repeat it for several; never comma-separate. Each row's matched_refs names the URLs it cites as you sent them, so one read checks a batch for duplicates.
queryquery · optional · string
A title containing it or two of its distinctive words (all, for a shorter query), or a body matching it in words or meaning. Titles first, the whole query before a few of its words.
assigneequery · optional · array
Whose: me (you and your teams), none, a user_… or team_….
linkedquery · optional · boolean
false: only tasks with no link of any kind, in either direction, to an open or a closed task. true: the rest.
limitquery · optional · integer
Defaults to 50. For more, follow next_cursor.
cursorquery · optional · string
The next_cursor of the previous page, with the same filters.

Responses

200The matching tasks, each with its computed readiness

400The request body or query string does not match the operation's schema, or a `calendar` task names no date (`calendar_requires_date`)

502Task bodies are stored in Naturali, and it did not answer this read (`naturali_unavailable`). Nothing was refused and no write is lost: retry the read later.

Generated from the spec this operation is implemented against, so the two names above cannot disagree with the surface a client sees.