Edit up to 100 tasks/projects in one call with preview and per-item read-back verification. Earlier edits remain if a later item fails.

Report server build, executable, OmniFocus version/capabilities and automation connectivity.

Search installed OmniFocus API docs (4.9+). Returns paginated TypeScript declarations and comments; does not execute code.

Gets the current state of your OmniFocus database

Add a new task to OmniFocus. Before creating a task that may already exist, call find_similar_tasks with the same name and reuse the returned id instead if a strong match comes back.

Add a new project to OmniFocus

Remove a task or project from OmniFocus

Edit a task or project in OmniFocus. Supports: rename, set/clear dates (due, defer, planned), flag/unflag, set status (complete, drop, reopen), add/remove/replace tags, set estimated minutes, move to different project/parent task/inbox.

Move an existing task to a project, parent task, or inbox

Add multiple tasks or projects to OmniFocus in a single operation. Supports tempId/parentTempId hierarchy wiring, dryRun preview, stopOnError, and atomic rollback. Before adding tasks that may already exist, call find_similar_tasks for each name and drop or replace any item with a strong match — batch creation multiplies duplicates.

Remove multiple tasks or projects from OmniFocus in a single operation

Get information about a specific task by ID or name

Get tasks completed today - view today's accomplishments

Get tasks from OmniFocus inbox perspective

Get flagged tasks from OmniFocus with optional project filtering

Get tasks from OmniFocus forecast perspective (due/deferred tasks in date range)

Get tasks filtered by OmniFocus tags (labels like @home, @work, @urgent). Use this for tag-based filtering, NOT for custom perspective names. Tags are labels assigned to individual tasks.

Advanced task filtering: status, dates (due/defer/planned/completed/added/modified/dropped), project, folder tree, tags, name/regex, note, repeat, estimate — plus and/or/not clauses, countOnly, field projection, and offset paging.

List all custom perspectives defined in OmniFocus. Pass includeRules to also get each perspective's filter rules and aggregation.

Get tasks from a specific OmniFocus custom perspective by name. Use this when user refers to perspective names like 'Today', 'Weekly Review', 'This Week' etc. - these are custom views created in OmniFocus, NOT tags. Supports hierarchical tree display of task relationships.

Append text to a task or project's note without overwriting existing content

Mark a completed task as incomplete again

Complete a task. Already-completed tasks are unchanged; repeating tasks advance on each call, so do not blindly retry.

Set or clear a repeating schedule on a task. Use the structured fields (frequency/interval/daysOfWeek/daysOfMonth/count/endDate) — e.g. 2nd Tuesday monthly — or pass a raw iCal RRULE via rule_string. Verified by read-back.

List and filter OmniFocus projects by folder, status, stalled state, with sorting and pagination

Search OmniFocus projects by name query

Get aggregate project counts by status (active, on hold, completed, dropped, stalled)

Get aggregate task counts with optional filters (project, tag, flagged, date range). Returns total, available, completed, overdue, due soon, flagged, deferred.

List all OmniFocus folders with project counts

Get details of an OmniFocus folder including its projects and subfolders

Create a new folder in OmniFocus, optionally nested under a parent folder

Update an OmniFocus folder's name or status

Delete an OmniFocus folder. WARNING: this also deletes all projects inside the folder.

List all OmniFocus tags with available task counts, filterable by status

Search OmniFocus tags by name query

Create a new tag in OmniFocus, optionally nested under a parent tag

Update an OmniFocus tag's name or status

Delete an OmniFocus tag

List children (subtasks) of a task, optionally recursive to show full hierarchy

Duplicate an existing task, optionally into a different project. Copies name, note, dates, flags, tags.

Move multiple tasks to a project, parent task, or inbox in a single operation

List all notifications (reminders) on a task

Add a notification (reminder) to a task — absolute date or relative to due date

Remove a notification (reminder) from a task by index

Reorder a task within its container — move before/after a sibling, or to beginning/ending. Controls next action in sequential projects.

Project review workflow. 'list_due' lists projects whose review date has arrived (all: true = every scheduled project); 'mark_reviewed' stamps one project or up to 100 via projectIds and advances each next review date by its own interval; 'set_schedule' sets the review interval (unit + steps).

Promote an existing task into a full project, keeping its subtasks, tags, and note. Optionally file it into a folder; without one the new project lands at the top level of the library.

Read-only analytics over the OmniFocus database: health_snapshot, velocity, overdue_clusters, or stalled_projects. Returns counts, rates, lists and dates as markdown — no scores and no recommendations — so the caller does the interpreting.

Replace a custom perspective's filter rules (and optionally its aggregation). Overwrites — read current rules first via list_custom_perspectives includeRules. Keys are validated before writing (OmniFocus silently accepts invalid rules), the write is read-back verified with rollback, and the previous rules are returned for undo.

Find existing OmniFocus tasks whose names are similar to a proposed new task name. Run this BEFORE creating a task that might already exist — it returns ranked matches with similarity scores and task IDs so you can reuse an existing task instead of creating a duplicate. Tolerant of typos, word reordering, and partial names.

List, read, add, or remove file attachments on a task or project. 'read' returns small files inline as base64 and writes larger ones to an absolute savePath; 'add' takes either base64 content or an absolute filePath. 10MB limit either way.

Application-level OmniFocus control: start a sync, step the undo/redo stack, read/set/clear the sidebar focus of the front window, or reveal (select) a task or project. Undo and redo are destructive and require confirm: true — the top of the undo stack is often the user's own manual edit.

Search tasks, projects, folders, and tags in one pass by name (optionally notes). Case-insensitive substring match; returns ids grouped by type with honest per-type totals.