List tasks
list_tasksRead-only
Retrieve tasks with optional filters for board, status, priority, assignee, due date, and search. Returns compact task summaries by default to manage token limits.
Instructions
List tasks with optional filters. Without any filter returns all tasks the user has access to across every board. By default returns a COMPACT shape to stay within token limits: { board: { id, name, slug, columns } | null, tasks: [{ id, number, title, status, priority, columnId, stageId, tags (names), assignees (count), dueDate }], count }. Pass detailed=true for full task objects (heavy — can exceed limits on large boards) or use get_task / get_task_by_number for one full task.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | ISO date string YYYY-MM-DD — filter tasks by this date | |
| slug | No | Deprecated alias of board_slug | |
| limit | No | Max number of tasks to return | |
| today | No | Return only today's relevant tasks (assigned to user, due today or overdue) | |
| number | No | Exact task number (#N without '#') | |
| offset | No | Pagination offset | |
| search | No | Search in task title/description; numeric value also matches task number | |
| status | No | Filter by task status | |
| detailed | No | Return full task objects instead of the compact shape (default false) | |
| group_by | No | Group counters by field | |
| priority | No | Filter by task priority | |
| board_slug | No | Board slug — limits results to tasks of that board | |
| watcher_id | No | Filter by watcher user UUID | |
| assignee_id | No | Filter by assignee user UUID |