Documentation

Filter Tasks Tool

Filter accessible team tasks, including unassigned and teammate-assigned work. For a complete board use exact project_id/board_id/column_id, status="any", and page_size (1–100). Follow pagination.next_cursor with unchanged filters until has_more=false. Cursor pages use ascending task IDs, not Kanban order; sort collected tasks by column_order/task_order. New IDs wait for a new traversal; concurrent edits, moves and assignments are not a snapshot. Without page_size/cursor, legacy limit/sort apply. Archived tasks/boards/projects are excluded.

Filter accessible team tasks, including unassigned and teammate-assigned work. For a complete board use exact project_id/board_id/column_id, status="any", and page_size (1–100). Follow pagination.next_cursor with unchanged filters until has_more=false. Cursor pages use ascending task IDs, not Kanban order; sort collected tasks by column_order/task_order. New IDs wait for a new traversal; concurrent edits, moves and assignments are not a snapshot. Without page_size/cursor, legacy limit/sort apply. Archived tasks/boards/projects are excluded.

Safety: Read only

Tool names, field names, and schema descriptions remain in canonical MCP English so copied calls match the server exactly.

Input schema

Field Type Required Description
project_name string no Narrow to one project by partial, case-insensitive name match. Omit to search all accessible projects.
project_id integer no Narrow to one project by exact ID. Takes precedence over project_name.
board_id integer no Exact board ID, within the selected accessible project(s).
column_id integer no Exact column ID, within the selected accessible project(s) and board. Combined with column_name when both are supplied.
column_name string no Match tasks whose board column name contains this (case-insensitive). E.g. "Bugs", "Backlog", "Done".
tag string no Match tasks having a tag whose name contains this (case-insensitive). E.g. "bug".
assignee_email string no Match tasks assigned to this user email.
status string no Filter by completion: "open" (default), "completed", or "any".
created_after string no Only tasks created on or after this date (YYYY-MM-DD). The "newly created" lever.
created_before string no Only tasks created on or before this date (YYYY-MM-DD).
due_after string no Only tasks with planned_end_date on or after this date (YYYY-MM-DD).
due_before string no Only tasks with planned_end_date on or before this date (YYYY-MM-DD).
priority_name string no Match tasks whose priority name contains this (case-insensitive). E.g. "High".
sort string no Ordering: "newest" (default), "oldest", "due_soonest", or "recently_updated".
limit integer no Legacy maximum tasks to return. Default 25, max 100. Omit with page_size/cursor.
page_size integer no Enable complete cursor traversal in ascending task ID order, 1–100 per page. Omit sort and limit. With cursor only, defaults to 50.
cursor string no Opaque pagination.next_cursor. Repeat the same filters and page_size. Omit on the first page.

Example prompt

Use filter-tasks-tool to help me with the relevant Taskavel task.

Example call

{
  "name": "filter-tasks-tool",
  "arguments": {}
}

Last reviewed Jul 26, 2026