MCP OmniFocus

MCP server for OmniFocus with auto-detection of Pro/Standard version.

Features

• Auto-detection: Automatically detects OmniFocus Pro or Standard
• Full Pro support: AppleScript for read/write with sync
• Standard fallback: SQLite read + URL scheme for create

Capabilities by Version

Feature	Pro (AppleScript)	Standard
Read tasks	✓	✓ (SQLite)
Create task	✓	✓ (URL scheme, syncs)
Update task	✓	⚠️ (SQLite, no sync)
Complete task	✓	⚠️ (SQLite, no sync)
Get projects	✓	✓ (SQLite)

⚠️ Standard SQLite write: Changes don't sync until OmniFocus restart.

Installation

Via npm (recommended)

npx mcp-omnifocus

From source

git clone https://github.com/avlihachev/mcp-omnifocus.git
cd mcp-omnifocus
npm install
npm run build

Claude Desktop Configuration

Add to ~/.claude/claude_desktop_config.json:

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

Or if installed from source:

{
  "mcpServers": {
    "omnifocus": {
      "command": "node",
      "args": ["/path/to/mcp-omnifocus/dist/index.js"]
    }
  }
}

Tools

omnifocus_get_tasks

Get tasks filtered by flagged, due today, or all.

omnifocus_create_task

Create a new task with name, note, project, flagged, dueDate.

omnifocus_update_task

Update existing task (Pro: syncs, Standard: SQLite only).

omnifocus_complete_task

Mark task as complete (Pro: syncs, Standard: SQLite only).

omnifocus_get_projects

Get list of active projects.