OmniFocus MCP Plus

A comprehensive MCP server for OmniFocus 4 with 50 tools covering task management, project/folder/tag CRUD, GTD review workflow, analytics, custom perspectives (including rule editing), attachments, notifications, and advanced filtering — plus MCP prompts, resources, tool annotations, and a Claude Code skill.

Originally forked from jqlts1/omnifocus-mcp-enhanced. Additional tools inspired by vitalyrodnenko/OmnifocusMCP.

Installation

Requires macOS with OmniFocus 4 and Node.js 18+.

From Source

git clone https://github.com/psufka/omnifocus-mcp-plus.git
cd omnifocus-mcp-plus
npm install && npm run build
npm test  # all tests should pass
claude mcp add omnifocus -- node "$(pwd)/dist/server.js"

Restart Claude Code to pick up the new server.

Related MCP server: OmniFocus MCP Enhanced

Tools (50)

Task Management

Task Queries

Notifications

Projects

App Control

Folders

Tags

MCP Surface & Environment

Beyond tools, the server exposes 4 prompts (weekly_review, inbox_processing, daily_planning, task_health_scan — surfaced as slash commands in Claude Code), 4 resources (omnifocus://inbox, today, flagged, stats), tool annotations (readOnly/destructive/idempotent hints on all 50 tools), and handshake instructions that steer clients toward the cheap tools. A Claude Code skill lives at docs/skills/omnifocus/ (install: ln -s "$(pwd)/docs/skills/omnifocus" ~/.claude/skills/omnifocus).

Environment variables: OMNIFOCUS_MCP_MAX_CONCURRENT (concurrent osascript processes, default 2, range 1–8 — OmniFocus serializes Apple Events on one thread), OMNIFOCUS_SCRIPT_TIMEOUT_MS (default 120000), OMNIFOCUS_SCRIPT_MAX_OUTPUT_BYTES (default 50MB).

Usage Examples

All tools are called automatically by Claude via MCP. The examples below show the tool parameters for common operations.

Tasks

Add a task with a due date and tags:

{
  "name": "Review quarterly report",
  "dueDate": "2026-03-15T17:00:00-05:00",
  "tags": ["Work", "Urgent"],
  "projectName": "Q1 Review"
}

Set a task to repeat every weekday:

{
  "task_id": "abc123",
  "rule_string": "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR",
  "schedule_type": "regularly"
}

Set a task to repeat 3 days after completion:

{
  "task_id": "abc123",
  "rule_string": "FREQ=DAILY;INTERVAL=3",
  "schedule_type": "from_completion"
}

Append to a task's note (without overwriting):

{
  "object_type": "task",
  "object_id": "abc123",
  "text": "\nUpdated 2026-03-10: waiting on response"
}

Projects

List stalled projects (active but stuck):

{ "stalledOnly": true }

List projects in a folder sorted by remaining tasks:

{
  "folder": "Work",
  "status": "active",
  "sortBy": "remainingTaskCount",
  "sortOrder": "desc"
}

Folders & Tags

Create a nested folder:

{ "name": "Q2 Projects", "parent": "Work" }

Create a nested tag:

{ "name": "Urgent", "parent": "Priority" }

Put a tag on hold:

{ "name_or_id": "Waiting", "status": "on_hold" }

Filtering

Get overdue tasks in a specific project:

{
  "overdue": true,
  "projectFilter": "Home Renovation"
}

Get tasks due this week with a specific tag:

{
  "dueThisWeek": true,
  "tagFilter": "Work"
}

Date Format

All dates must use full ISO 8601 with timezone offset. Bare dates like 2026-03-15 resolve to UTC midnight and display as the wrong day in local time.

"2026-03-15T17:00:00-05:00"   (CDT)
"2026-03-15T17:00:00-06:00"   (CST)

RRULE Reference

The set_task_repetition tool uses iCal RRULE syntax:

Architecture

All tools use OmniJS via JXA — inline JavaScript executed inside OmniFocus via runOmniJs(). No AppleScript escaping issues, native access to all OmniJS APIs. Query tools use external .js scripts in src/utils/omnifocusScripts/ loaded via executeOmniFocusScript(). The core task/project CRUD tools (add, edit, remove) were migrated from AppleScript to OmniJS in v0.3.0.

Changelog

Current version: 0.5.1. See CHANGELOG.md for the full release history.

Known Limitations

• Parameter injection in executeOmniFocusScript is fragile — Uses regex replacement for query scripts. CRUD tools use direct JSON injection via runOmniJs() instead.

• Notification API — Relative notification offset retrieval may not work on all OmniFocus versions. Absolute notifications are fully supported.

Contributing

PRs welcome! All tools use OmniJS — write inline JavaScript that runs inside OmniFocus via runOmniJs(). No escaping issues, full access to the OmniJS API. See src/tools/primitives/folderTools.ts for examples.

To add a new tool:

1. Create a primitive in src/tools/primitives/yourTool.ts

2. Create a definition in src/tools/definitions/yourTool.ts (Zod schema + handler)

3. Register in src/server.ts

4. npm run build && npm test

Credits

• jqlts1/omnifocus-mcp-enhanced — original MCP server with perspective support

• vitalyrodnenko/OmnifocusMCP — reference implementation for folder/tag CRUD, project listing, and OmniJS patterns

License

MIT