Omnifocus

Name: Omnifocus
Author: alexhannaonline

@alexhannaonline

About Omnifocus

An MCP server that gives AI assistants full access to OmniFocus via Omni Automation. 41 tools for tasks, projects, folders, tags, subtask hierarchies, notifications, attachments, analytics, and data export.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Omnifocus?

The Omnifocus MCP server gives AI assistants full access to OmniFocus via Omni Automation. It provides 41 tools for tasks, projects, folders, tags, subtask hierarchies, notifications, attachments, analytics, and data export, running scripts inside OmniFocus's native automation engine.

How to use Omnifocus?

Clone the repository, install dependencies with npm install, and build with npm run build. Configure your MCP client (e.g., Claude Desktop or Claude Code) by adding a server entry pointing to the built dist/index.js file, optionally setting LOG_LEVEL. Requires macOS, OmniFocus 4.6+, Node.js 18+, and macOS automation permission for OmniFocus.

Key features of Omnifocus

41 MCP tools across 10 domain categories
Full CRUD for tasks, projects, folders, tags
Hierarchical subtask management with nesting
Notification system with absolute and relative alarms
Attachment and linked file support
Productivity analytics, velocity, and overdue analysis
Recurring task analysis and pattern statistics
Data export to JSON or CSV with field selection
TTL-based caching (30s tasks, 5min projects, 1h analytics)

Use cases of Omnifocus

Query today’s agenda, flagged items, or overdue tasks
Create, update, complete, or delete tasks via AI assistant
Organize projects within folders and manage subtask hierarchies
Export personal task data for reporting or backup
Analyze productivity trends and recurring task frequencies

FAQ from Omnifocus

Does the server directly access the OmniFocus database?

No. All interaction goes through the official Omni Automation API via osascript -l JavaScript calling app.evaluateJavascript(). No direct database access.

What are the system requirements?

macOS (required for osascript), OmniFocus 4.6+ installed, Node.js 18+, and macOS automation permission for OmniFocus (granted on first use).

Can I create recurring tasks?

No. The server can read and analyze recurring patterns, but cannot create repeat rules due to Omni Automation API limitations.

Does the server support perspective management?

No. The Omni Automation API is read-only for perspectives, so the server cannot manage perspectives.

Can I link files with http/https URLs?

No. add_linked_file only accepts file:// URLs; OmniFocus rejects http/https links.

Comments

More Data & Analytics MCP servers

Google Ads MCP

cohnen

An MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all th

657