MCP server that gives AI assistants full control over OmniFocus on macOS.
Model Context Protocol (MCP) server for OmniFocus on macOS, with Rust, Python, and TypeScript implementations
星标
43
工具
—
可用率
—
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.
Task payloads include addedDate and changedDate (ISO 8601 or null)
Projects (11 tools)
CRUD — create, get, update, delete projects
Lifecycle — complete, uncomplete, set status (active/on-hold/dropped)
Organization — move between folders, search by name
Filtering — by folder, status, completion date range, stalled-only flag
Sorting — by name, due date, or other fields
Aggregate counts — project counts by status, optionally scoped to a folder
Project Lifecycle Semantics
Use complete_project when work is finished/closed (done/completed).
Use set_project_status for organizational state only:
active = current
on_hold = paused (UI wording is often "on hold"/"on-hold")
dropped = intentionally abandoned/cancelled, not completed
Use uncomplete_project to reopen a completed project back to active.
In user-facing summaries, present business meaning first (project name,
folder, and status transition), and include opaque IDs only as secondary
references.
Tags (5 tools)
CRUD — create, update (name and status), delete
List — with status filter (active/on-hold/dropped/all), sorting, and limits
Search — fuzzy name matching
Folders (5 tools)
CRUD — create, get (with child projects and subfolders), update, delete
Hierarchy — create nested folders with parent parameter
List — all folders with limits
Forecast (1 tool)
Structured view with sections: overdue, due today, flagged, deferred, and due this week
Perspectives (1 tool)
List all available OmniFocus perspectives
Resources (3)
Live snapshots available to MCP clients:
Resource
Description
Inbox
Current inbox tasks
Today
Today's forecast (overdue + due today + flagged)
Active Projects
All active projects with task counts
Prompts (4)
Ready-to-use review workflows:
Prompt
Description
Daily Review
Due-soon, overdue, and flagged tasks for daily planning
Weekly Review
Active projects and next-action coverage analysis
Inbox Processing
One-by-one inbox clarification decisions
Project Planning
Guided planning for a specific project
Implementations
Three implementations with identical tool names, parameters, and response shapes:
The server runs JXA (JavaScript for Automation) scripts through macOS osascript. Each script uses the OmniFocus evaluateJavascript bridge to execute Omni Automation JavaScript inside OmniFocus itself, where full APIs like flattenedTasks, Task.Status, and new Task() are available. Data is serialized as JSON and returned through the MCP protocol with consistent schemas across all three implementations.