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.