omnifocus -enhanced

This MCP server wraps the OmniFocus Enhanced MCP package and exposes a rich set of tools to automate and query OmniFocus data. It supports native access to OmniFocus custom perspectives, hierarchical task trees, and AI-assisted workflows via Claude integration. You can inspect perspectives, list and read custom perspectives, manage tasks and projects with full CRUD operations, and apply advanced filters to surface exactly the tasks you need. Typical interactions include creating subtasks, querying by ID or tag, and leveraging the built-in perspective tools to fetch inbox, flagged, forecast, and tagged views. The server is designed to work with Claude integrations and can be invoked from the Claude MCP workflow to drive OmniFocus-based automation.

To use it, install the MCP server package (omnifocus-mcp-enhanced) and run it through a Node.js environment. From there you can call commands such as get_inbox_tasks, get_flagged_tasks, get_forecast_tasks, get_tasks_by_tag, filter_tasks, and the custom perspective tools (e.g., list_custom_perspectives, get_custom_perspective_tasks) to read and manipulate OmniFocus data. The server also supports advanced operations like move_task and edit_item for moving tasks across projects or inbox, with safeguards for duplicate names and cycles. If you’re integrating with Claude, you can wire these commands into your Claude workflows to automate planning and execution using OmniFocus data.

Prerequisites:\n- macOS 10.15+ (OmniFocus is macOS-only)\n- OmniFocus 3+\n- Node.js 18+ (for running the MCP server)\n- Claude Code (for MCP integration)\n\nStep 1: Install Node.js and npm (if not already installed)\n\n - On macOS with Homebrew:\n brew install node\n\nStep 2: Install the MCP server package globally (recommended for quick start)\n\n - Quick install (one-line):\n claude mcp add omnifocus-enhanced -- npx -y omnifocus-mcp-enhanced\n\n - Or install the package globally and run locally:\n npm install -g omnifocus-mcp-enhanced@latest\n claude mcp add omnifocus-enhanced -- omnifocus-mcp-enhanced\n\nStep 3: If you prefer a local project setup:\n\n git clone https://github.com/jqlts1/omnifocus-mcp-enhanced.git\n cd omnifocus-mcp-enhanced\n npm install && npm run build\n claude mcp add omnifocus-enhanced -- node "/path/to/omnifocus-mcp-enhanced/dist/server.js"\n\nStep 4: Run the MCP server (example)\n\n npx -y omnifocus-mcp-enhanced\n\nNotes:\n- Ensure OmniFocus is installed and running on macOS.\n- The installation steps above assume Claude is configured to interface with MCP servers.\n- If you build locally, point to the built dist/server.js in your claude mcp command.

Tips and caveats:\n- macOS 10.15+ is required due to OmniFocus compatibility.\n- Custom Perspectives require OmniFocus Pro.\n- For large task hierarchies, test batch operations in a staging perspective before applying broadly.\n- The CLI tools support hierarchical task operations; use parentTaskName/parentTaskId when creating subtasks.\n- When using get_custom_perspective_tasks, ensure your perspectiveName matches exactly (including any locale-specific names).\n- If you encounter environment issues, verify Node.js 18+ is active and that claude is configured to reach the MCP endpoint.\n- The npm_package field is populated to help with automated documentation and discovery tooling.