List Weeek tasks
weeek_list_tasksRead-onlyIdempotent
Filter and paginate Weeek task summaries by project, board, column, assignee, or status to locate the task you need without pulling full details.
Instructions
PRIMARY tool for task discovery and filtering: returns one page of Weeek tasks filtered by project_id / board_id / board_column_id / assignee_id / completed, paginated by offset+per_page (default 20, max 100). Use the filters to locate the card a write tool is about to act on instead of paging a whole project. DISTINCT from weeek_get_task — this returns task summaries (no description / details); fetch a single full task via weeek_get_task. Use when the agent needs a list view; follow hasMore for the next page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | Pagination offset (number of items to skip) | |
| board_id | No | Filter to tasks on this board (id from weeek_list_boards). An id that does not exist is rejected as an error, not answered with an empty list. | |
| per_page | No | Pagination page size (1-100). Default 20 — sized so a single page fits comfortably under the 25k MCP-token cap that most clients use for `tools/call` responses; raise explicitly if you need a larger page and have the budget for it. | |
| completed | No | If true, return only completed tasks; if false, only open ones | |
| project_id | No | Filter to tasks of this project | |
| assignee_id | No | Filter to tasks this member is assigned to — matches any assignee, not only the primary one (a task where the member is a secondary assignee still matches). UUID from weeek_list_members.id. A UUID that is not a member of this workspace is rejected as an error (weeek_validation_error, HTTP 422), not answered with an empty list. | |
| board_column_id | No | Filter to tasks sitting in this board column — the status filter (id from weeek_list_board_columns). Column ids are unique across boards, so this narrows on its own; board_id is not required alongside it. An id that does not exist is rejected as an error, not answered with an empty list. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tasks | Yes | Tasks matching the filters | |
| hasMore | Yes | True if more tasks exist beyond this page; call again with offset = previous offset + tasks.length | |
| truncated | Yes | True if the response was clipped by the server's MAX_RESPONSE_CHARS gate. Independent from hasMore (pagination): truncated=true means the local byte-budget gate fired, so re-issue with smaller per_page / narrower filters or raise MAX_RESPONSE_CHARS in the server env. |