list_tasks
Retrieve tasks from a plan or bucket with advanced filters like priority, due dates, assignees, completion status, and keyword search.
Instructions
List tasks in a plan or bucket with advanced filtering
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| skip | No | Number of tasks to skip (for pagination, use with limit) | |
| limit | No | Maximum number of tasks to return (pagination) | |
| fields | No | Comma-separated field names to return (e.g., 'id,title,bucketId,percentComplete') - reduces token usage | |
| planId | No | Plan ID (optional - if not provided, lists tasks assigned to you) | |
| search | No | Search tasks by keyword using fuzzy matching. Matches against title, and description if includeDetails is true. | |
| bucketId | No | Bucket ID (optional - filters by bucket within the plan) | |
| dueAfter | No | Due date after this date (ISO 8601: '2026-03-27' or relative: 'today', 'tomorrow', 'next-week') | |
| priority | No | Filter by priority, supports multiple values (OR logic). e.g. [1,3] for urgent+important. Values: 1=urgent, 3=important, 5=medium, 9=low | |
| dueBefore | No | Due date before this date (ISO 8601: '2026-03-27' or relative: 'today', 'tomorrow', 'next-week') | |
| isArchived | No | Filter by archived status (true/false/undefined for both) | |
| assignedToMe | No | Filter by tasks assigned to current user (only works with planId) | |
| createdAfter | No | Created after this date (ISO 8601 or relative: 'today', 'this-week', 'last-week') | |
| createdBefore | No | Created before this date (ISO 8601 or relative: 'today', 'this-week', 'last-week') | |
| completedAfter | No | Completed after this date (ISO 8601 or relative) | |
| includeDetails | No | Include task details (description, checklist, references) via $expand=details | |
| completedBefore | No | Completed before this date (ISO 8601 or relative) | |
| percentComplete | No | Filter by percent complete. Supports comparison operators: '>50', '>=50', '<100', '<=100', or exact value '50'. Use 0 for not started, 100 for completed | |
| searchThreshold | No | Fuzzy search sensitivity: 0.0 = exact match only, 1.0 = match anything. Default is 0.4. | |
| appliedCategories | No | Filter tasks by categories, comma-separated (e.g., 'category1' or 'category1,category3'). Returns tasks that have ALL specified categories set to true. | |
| assignedToUserIds | No | Filter tasks assigned to any of the specified user IDs (OR logic). e.g. ['user-id-1', 'user-id-2'] |