task_list
tools/call
List project tasks, across every project or one, in board order. Filter by status and assignee: assignee me lists your own tasks, unassigned lists tasks nobody has claimed. Use status ready with assignee unassigned to find work to pick up. When partial is true, more may match: call again with the same filters and the returned cursor until partial is false.
Scopes
read:projects
Inputs
- projectstring
- Project name, key (DEV) or ID. Omit for every project.
- statusstring
- Status name (Ready, In progress), kind (backlog, ready, active, waiting, review, done) or ID
- assigneestring
- me, unassigned, anyone, or an actor ID
- textstring
- Words to search for
- sourceUrlstring
- Only the tasks filed for this https source link, such as a Slack message URL; the other filters still apply
- limitnumber
- cursorstring
- The cursor from the previous task_list call with the same filters
Returns
Tasks in board order, whether more may match, and the next cursor. A call returns content[0].text with the JSON result and structuredContent.result with the same value.
Listed when
The key has read:projects.