Health check for OmniFocus: running state, Pro vs Standard, undo availability, and headline counts.

Use this first when a session starts or a call fails. It never dumps tasks.

Read tasks from Inbox, Flagged, Forecast, tags, projects, custom perspectives, or an ad-hoc filter.

Results are paginated and compact by default. Use count_tasks when you only need totals. Custom perspectives (source=custom) are saved views, not tags.

Count matching tasks with a status breakdown and known estimated minutes.

Use this before listing when you need scale, daily capacity, or a review total.

List projects, including review metadata and stalled detection.

List OmniFocus folders. detailed includes child projects and subfolders.

List or search tags, including hierarchy paths such as 'Work / Deep'.

List built-in and custom perspectives, or read a custom perspective's filter rules.

Custom perspectives require OmniFocus Pro. This does not return the tasks inside a perspective; use query_tasks with source=custom for that.

Read one attachment previously listed on a task. Images are returned as image content when possible.

Create one task, optionally with subtasks, tags, dates, and a repeat rule.

Create a project, optionally inside a folder and with an initial task list.

Create many tasks or projects in one OmniJS call. Later items can parent to earlier names.

Create one verified project tree from a user-confirmed outline. Rolls back with Undo on failure.

Edit a task or project, including optional move, tags, dates, and status.

Mark tasks or projects complete, incomplete, or dropped. Repeating completes report the generated instance.

Move tasks to a project, parent task, or the Inbox. Cycles are rejected before any move.

Delete tasks, projects, or folders. First call returns a cascade preview and confirmToken; second call executes.

Duplicate tasks or whole projects. Duplicating a project is useful as a template.

Set, update, or clear a task's OmniFocus 4.7+ repetition rule. Restores the previous rule on failure.

Create, rename, move, or delete a folder. Deleting a folder also deletes its projects; that path requires confirmToken.

Create, rename, nest, or delete a tag. On-hold tags block next actions.

Update a custom perspective's filter rules in place. OmniFocus cannot create or delete perspectives via automation.

List, add, or remove task reminders (absolute or due-relative).

Append to a task or project note without overwriting it.

Mark confirmed projects reviewed with one timestamp and return the OmniFocus-generated next review dates.

Undo or redo the last OmniFocus change, run database clean-up, or reveal an item in the OmniFocus UI.