The backbone task query tool for agents deciding what to work on. Filters the authenticated user's accessible tasks by project, board column, tag, assignee, status, creation/due date windows, and priority, with configurable sorting. Use created_after to surface newly created work. Returns a compact, decision-ready list. Every query is scoped to projects the user owns or belongs to.
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. |
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 | Maximum tasks to return. Default 25, max 100. |
Example prompt
Use filter-tasks-tool to help me with the relevant Taskavel task.
Example call
{
"name": "filter-tasks-tool",
"arguments": {}
}