tasks_list
Read tasks. view=board returns a board scan: 50 concise current-state rows by default, no descriptions/comments. Other reads default to a small task page (10, bounded response). The same filters with page.next_cursor as cursor continue; pages are not concatenated automatically. Task ordering is live keyset: edits to sort/filter fields may skip or repeat rows; a new read starts a fresh queue. Fields in omitted are partial; tasks_get view=field expands them. detail=full explicitly permits unbounded descriptions. task_id reads one current task; tasks_get covers history/field options. review_for_closure reports its source candidate limit. tasks_overview covers project direction and work; tasks_summary gives counts and memory_search durable guidance.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>"
},
"name": "tasks_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Case-insensitive text search over title and description. | |
| area | No | Filter to tasks in this subsystem. | |
| kind | No | History kind; defaults to comments. revisions holds saved guidance text; reviews holds explicit account review records. | |
| sort | No | Sort order. Default (omitted) is the smart order: open before done, by priority, newest first. | |
| type | No | Filter by one type or a comma-separated list. Custom labels are supported. vision — why the organization exists. philosophy — a belief guiding trade-offs, including why it matters. directive — a rule or instruction, including what it supersedes. decision — a steer from the person who owns the project: their words, what it changes, what it replaces, the work it governs. sop — how to carry out a recurring job. spec — what to build and its acceptance criteria. roadmap — direction and outcomes for work ahead. epic — a larger outcome grouping related tasks. task — a concrete piece of current work. bug — behavior that needs correction. report — an observation, incident or customer finding. principle — a reusable rule for making decisions. learning — a lesson supported by experience or evidence. supplier — facts about an external service or supplier. content — a draft or plan for published material. policy — a standing rule governing operations. stance — a position on a subject and its reasoning. When the person who owns the project changes direction, parks or picks something, or overrules a plan, record it as a decision the same day, quoting them. | |
| view | No | board returns only current-state rows, default 50/max100, under 32,000 data characters; unfinished tasks by default, waiting/needs_review/blocked rows first. Recorded release tags flag closure review. Explicit status/sort override those defaults. current preserves detailed excerpts; full is unbounded. | |
| field | No | Top-level field to expand with view=field. | |
| limit | No | Max rows to return (default 10). Compact pages return at most 20 rows and detail=full up to 500; view=board defaults to 50, max 100. The payload budget may return fewer; page.limit is the effective cap. | |
| stale | No | Only in_progress tasks untouched for more than stale_days. | |
| active | No | Shortcut for "what is on my plate" — status open + in_progress. Ignored if an explicit status is given. | |
| cursor | No | Opaque next_cursor from the previous page, valid only with the original filters and view. It cannot be combined with offset. | |
| detail | No | The "full" value includes complete descriptions instead of compact excerpts. | |
| offset | No | Optional fresh offset traversal. Cursor provides checked continuation; the two fields cannot be combined. | |
| status | No | Work records only. | |
| task_id | No | Optional task ID beginning with tsk_ for a bounded current-state read instead of a list. Comments and activity are retrieved separately through tasks_get. A short prefix resolves when unique; an ambiguous prefix returns candidates. | |
| assignee | No | Filter to tasks assigned to this person. | |
| event_id | No | History event ID for a field expansion; kind is repeated. | |
| parent_id | No | Filter to sub-tasks of this parent; the string "null" selects only top-level tasks without a parent. | |
| project_id | Yes | Project ID (UUID), subdomain, or slug, resolved server-side; 'default' is the organization's shared task board. | |
| stale_days | No | Staleness threshold in days (default 7). Also controls the per-row `stale` flag. | |
| waiting_on | No | Filter explicit waiting signals; requires view=board. none selects tasks with no recorded wait. | |
| include_archived | No | Default false. Only affects results when a type filter is present: archived rows are hidden unless this is true. | |
| include_superseded | No | Default true for task history/search; false excludes records replaced by a superseded_by pointer or supersedes relationship. Memory recall defaults to false. | |
| review_for_closure | No | Surface-only review queue returning report rows whose parent task carries a shipped_in version, annotated with resolved_by_version. It does not change status and ignores the other filters. |