OmniFocus MCP

MCP server that gives AI assistants full control over OmniFocus on macOS.

45 tools, 3 resources, and 4 prompts covering tasks, projects, tags, folders, perspectives, forecast, notifications, and review workflows — all through the Model Context Protocol.

This project is not affiliated with, endorsed by, or associated with The Omni Group or OmniFocus. OmniFocus is a trademark of The Omni Group. This is an independent, non-commercial open-source project.

Quick Start

Install via Homebrew (if you don't have Homebrew, see the Homebrew installation guide):

brew tap vitalyrodnenko/omnifocus-mcp
brew install omnifocus-mcp

Then add to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "omnifocus": {
      "command": "omnifocus-mcp",
      "args": []
    }
  }
}

That's it. The AI assistant now has full OmniFocus access.

What It Can Do

Tasks (23 tools)

Full lifecycle management for OmniFocus tasks:

• CRUD — create, get, update, delete individual tasks
• Batch operations — create, move, or delete multiple tasks in a single call
• Subtasks — create and list subtasks under any parent task
• Completion — mark complete, mark incomplete (supports repeating tasks)
• Search — full-text search across task names and notes with all filters applied
• Move and reparent — relocate tasks between projects, reparent tasks under other tasks, or move subtasks back to inbox/project without delete/recreate
• Duplicate — clone a task with all properties and optional subtasks
• Notifications — list, add, and remove notifications (absolute date or relative offset)
• Repetition — set or clear repetition rules with schedule type (regularly/after completion)
• Notes — append text to task notes without overwriting
• Safety model — destructive delete confirmations stay separate from non-destructive move/update workflows
• Aggregate counts — fast "how many" queries without listing individual tasks

Advanced Filtering

list_tasks and search_tasks support powerful filter combinations:

Sorting

All list/search tools support sortBy and sortOrder:

• Sort by: name, dueDate, deferDate, completionDate, estimatedMinutes, project, flagged, addedDate, changedDate, plannedDate
• Aliases: added -> addedDate, modified -> changedDate, planned -> plannedDate
• Sort order: asc (default) or desc
• Task payloads include addedDate and changedDate (ISO 8601 or null)

Projects (11 tools)

• CRUD — create, get, update, delete pro

... View full README on GitHub