filter_tasks
Read-onlyIdempotent
Filter OmniFocus tasks by status, dates, projects, tags, search, and more, with optional subtask tree expansion.
Instructions
Advanced task filtering by status, dates, projects, tags, search, and more, with optional subtask-tree expansion
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of tasks to return (default: 100) | |
| cursor | No | Opaque continuation cursor returned by a previous filter_tasks page | |
| sortBy | No | Sort results by field | |
| flagged | No | Filter by flagged status | |
| hasNote | No | Filter tasks that have notes | |
| inInbox | No | Filter tasks in inbox | |
| overdue | No | Show overdue tasks only | |
| dueAfter | No | Show tasks due strictly after this date/time (ISO format: YYYY-MM-DD or full ISO) | |
| dueToday | No | Show tasks due today | |
| dueBefore | No | Show tasks due strictly before this date/time (ISO format: YYYY-MM-DD or full ISO) | |
| sortOrder | No | Sort order (default: asc) | |
| tagFilter | No | Filter by tag name(s). Can be single tag or array of tags | |
| deferAfter | No | Show tasks with defer date strictly after this date/time (ISO format: YYYY-MM-DD or full ISO) | |
| deferToday | No | Show tasks deferred to today | |
| outputMode | No | Output detail: detailed (default) or compact for broad planning queries | |
| searchText | No | Search in task names and notes | |
| taskStatus | No | Filter by task status. Can specify multiple statuses | |
| deferBefore | No | Show tasks with defer date strictly before this date/time (ISO format: YYYY-MM-DD or full ISO) | |
| dueThisWeek | No | Show tasks due this week | |
| estimateMax | No | Maximum estimated minutes | |
| estimateMin | No | Minimum estimated minutes | |
| hasEstimate | No | Filter tasks that have time estimates | |
| perspective | No | Limit search to specific perspective: inbox, flagged, all tasks | |
| dueThisMonth | No | Show tasks due this month | |
| plannedAfter | No | Show tasks planned strictly after this date/time (ISO format: YYYY-MM-DD or full ISO) | |
| plannedToday | No | Show tasks planned for today | |
| showSubtasks | No | Expand each matching task's subtask tree (default: false) | |
| deferThisWeek | No | Show tasks deferred to this week | |
| exactTagMatch | No | Set to true for exact tag name match, false for partial (default: false) | |
| plannedBefore | No | Show tasks planned strictly before this date/time (ISO format: YYYY-MM-DD or full ISO) | |
| projectFilter | No | Filter by project name (partial match) | |
| completedAfter | No | Show tasks completed strictly after this date/time (ISO format: YYYY-MM-DD or full ISO) | |
| completedToday | No | Show tasks completed today | |
| deferAvailable | No | Show tasks whose defer date has passed (now available) | |
| completedBefore | No | Show tasks completed strictly before this date/time (ISO format: YYYY-MM-DD or full ISO) | |
| maxSubtaskDepth | No | Maximum subtask levels to expand; omitted means unlimited | |
| plannedThisWeek | No | Show tasks planned for this week | |
| plannedThisMonth | No | Show tasks planned for this month | |
| completedThisWeek | No | Show tasks completed this week | |
| completedThisMonth | No | Show tasks completed this month |