get_projects
Fetch projects from OmniFocus with filters for project ID, search query, status (flagged, on hold, completed, stalled), tags, due/defer/planned dates, task count, and health metrics. Include optional fields like notes and last activity.
Instructions
Retrieve projects with optional filtering.
Parameters:
project_id: str -- filter to specific project
query: str -- search name/note/folder (case-insensitive)
flagged_only, on_hold_only, completed_only: bool
stalled_only: bool -- active projects with no available next actions
include_dropped, include_completed: bool -- include hidden states
include_full_notes: bool
include_task_health: bool -- adds remainingCount, availableCount, overdueCount, deferredCount, stalled, health
include_last_activity: bool -- adds lastActivityDate
has_overdue_tasks: bool -- implies include_task_health
tag_filter: list[str] -- projects with ALL specified tags
due_after, due_before, due_on: str -- ISO date filters for due date
defer_after, defer_before, defer_on: str -- ISO date filters for defer date
planned_after, planned_before, planned_on: str
completion_after, completion_before, completion_on: str
dropped_after, dropped_before, dropped_on: str
created_after, created_before, created_on: str
modified_after, modified_before, modified_on: str
min_task_count: int
has_no_due_dates: bool
sort_by: str -- "name", "due_date", "defer_date", "planned_date", "creation_date", "modification_date", "completion_date", "dropped_date"; sort_order: str -- "asc"/"desc"
Returns: id, name, folderPath, status, projectType, sequential (deprecated), completedByChildren, flagged, creationDate, modificationDate, completionDate, droppedDate, dueDate, deferDate, plannedDate, tags, note, lastReviewDate, nextReviewDate, reviewIntervalValue, reviewIntervalUnit. Optional health/activity fields when requested.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | No | ||
| include_full_notes | No | ||
| on_hold_only | No | ||
| query | No | ||
| include_task_health | No | ||
| include_last_activity | No | ||
| stalled_only | No | ||
| flagged_only | No | ||
| include_dropped | No | ||
| include_completed | No | ||
| completed_only | No | ||
| tag_filter | No | ||
| planned_after | No | ||
| planned_before | No | ||
| planned_on | No | ||
| due_after | No | ||
| due_before | No | ||
| due_on | No | ||
| defer_after | No | ||
| defer_before | No | ||
| defer_on | No | ||
| completion_after | No | ||
| completion_before | No | ||
| completion_on | No | ||
| dropped_after | No | ||
| dropped_before | No | ||
| dropped_on | No | ||
| created_after | No | ||
| created_before | No | ||
| created_on | No | ||
| modified_on | No | ||
| has_overdue_tasks | No | ||
| sort_by | No | ||
| sort_order | No | asc | |
| modified_after | No | ||
| modified_before | No | ||
| min_task_count | No | ||
| has_no_due_dates | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |