list_tasks
Retrieve and filter tasks by project, board, assignee, status, labels, overdue status, or search text, with sorting and pagination for task queries.
Instructions
List tasks with filters. The main task query tool.
Where to look (pick one):
project="" every task of that project; project="all" = every open project
scope="mine" (default) tasks assigned to me + my personal tasks
scope="outbox" tasks I created for other people
scope="everything" inbox + outbox + every open project
Filters (combine freely, applied exactly): board (title/id, needs project), assignee (name/id/"me"), unassigned, owner (creator), label (title/id), status "open"|"done"|"all", overdue_only, query (words that must all appear in title/notes/ checklist; Persian/Arabic letter variants match).
sort: "deadline" (default; overdue first), "board" (kanban order, default for a project), "modified", "created". Paginated: returns total, has_more and next_offset.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_tasks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | ||
| board | No | ||
| label | No | ||
| limit | No | ||
| owner | No | ||
| query | No | ||
| scope | No | ||
| offset | No | ||
| status | No | open | |
| project | No | ||
| assignee | No | ||
| unassigned | No | ||
| notes_chars | No | ||
| overdue_only | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||