OmniFocus MCP Server

A Model Context Protocol (MCP) server for integrating OmniFocus with Claude Desktop. This server provides Claude with access to your OmniFocus tasks and projects, enabling AI-powered task management and weekly reviews.

- 🎯OmniFocus Integration- Access tasks and projects from OmniFocus
- 🔧Active Task Filtering- Get only uncompleted tasks, excluding templates and system items
- 🚀TypeScript + MCP SDK- Type-safe and maintainable
- 🔒Secure Automation- Uses official Omni Automation JavaScript API
- 📱Claude Desktop Ready- Works seamlessly with Claude Desktop

Retrieve all tasks from OmniFocus with filtering options:

- includeCompleted(boolean) - Include completed tasks (default: false)
- limit(number) - Maximum number of tasks to return (default: 100)

Retrieve only active (uncompleted) tasks, automatically filtering out:

- Tasks from "Templates" folders
- Tasks containing template placeholders («,»)
- Tasks with synced preferences markers (⚙️)

Retrieve all active projects from OmniFocus.

- macOSwith OmniFocus installed
- Node.js 23.10.0or higher
- Claude Desktopapplication
- Automation permissionsfor OmniFocus

git clone https://github.com/mdoel/omnifocus-mcp cd omnifocus-mcp

Add this to your Claude Desktop MCP configuration:

{ "mcpServers": { "omnifocus": { "command": "/path/to/omnifocus/run-server.sh", "args": [] } } }

Important:Replace/path/to/omnifocus/with the actual path to your project directory.

The first time you run the server, macOS will prompt you to grant automation permissions for OmniFocus. Click "Allow" when prompted.

Note:If you encounter permission issues, you may need to temporarily uncomment theosascriptlines inrun-server.shto trigger the permission dialog. After granting permissions, comment those lines out again to avoid the dialog on every startup.

Restart Claude Desktopto load the new MCP server.

- "Get all my active tasks from OmniFocus"
- "Show me my projects"
- "What tasks do I have for today?"
- "Help me with my weekly review"

- OmniFocusClient- Handles communication with OmniFocus via Omni Automation
- OmniFocusJXA- Utility for building and executing JXA scripts
- OmniFocusMCPServer- Main MCP server implementation

src/ ├── index.ts # Main entry point ├── server.ts # MCP server implementation ├── omnifocus/ │ ├── client.ts # OmniFocus automation client │ └── omnifocus-jxa.ts # JXA script utilities └── types/ └── omnifocus.ts # TypeScript definitions

# Build the project npm run build # Watch mode for development npm run dev

# Test with command line arguments node dist/index.js all # Get all tasks node dist/index.js active # Get active tasks only node dist/index.js projects # Get projects only

# Test basic connection osascript -l JavaScript -e "Application('OmniFocus').running()" # Test task retrieval osascript -l JavaScript -e " const app = Application('OmniFocus'); const doc = app.defaultDocument; const tasks = doc.flattenedTasks(); console.log('Found ' + tasks.length + ' tasks'); "

If Claude Desktop can't connect to the server:
- Check the script pathin your Claude Desktop configuration
- Verify permissions- ensure therun-server.shscript is executable:

chmod +x run-server.sh

If you get automation permission errors:
- OpenSystem Preferences > Security & Privacy > Privacy
- SelectAutomationfrom the left sidebar
- Find your terminal/shell and checkOmniFocus
- Restart your terminal and try again

- Ensure OmniFocus is installed and running
- Verify the app name is "OmniFocus" (not "OmniFocus 3" or something similar)
- Check that OmniFocus is not in the trash or disabled

- The server may take time to process large OmniFocus databases
- Consider using thelimitparameter to reduce the number of tasks returned
- Ensure OmniFocus is not performing other operations

This project is designed to be extensible. To add new functionality:
- Add new toolsin thesrc/omnifocus/directory
- Update the serverto register new tools
- Test thoroughlywith your OmniFocus data
- Submit a pull requestwith clear documentation

MIT License - seeLICENSEfile for details.

Voice-first planning app. Dictate voice notes on iOS/Apple Watch, AI creates structured tasks and events. 21 MCP tools (read + write). Connect from Claude Code, Cursor, Windsurf. Free trial with promo code MCPBETA26.