Omnifocus
@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.
More Data & Analytics MCP servers
ArXiv MCP Server
blazickjpA Model Context Protocol server for searching and analyzing arXiv papers
MCP Deep Web Research Server (v0.3.0)
qpd-vEnhanced MCP server for deep web research
Google Ads MCP
cohnenAn 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
arxiv-latex MCP Server
takashiishidaMCP server that uses arxiv-to-prompt to fetch and process arXiv LaTeX sources for precise interpretation of mathematical expressions in scientific papers.
Bright Data MCP
brightdata-comA powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.
Comments