OmniFocus MCP
A Model Context Protocol (MCP) implementation that connects Claude Desktop with OmniFocus 4, enabling natural language task management through AI.
Overview
OmniFocus MCP serves as a bridge between Claude Desktop and OmniFocus 4, allowing you to interact with your tasks, projects, and tags through natural language. It implements the Model Context Protocol (MCP) which enables Claude to integrate with external applications.
Features
- Create, read, update, and delete tasks in OmniFocus
- Manage projects and tags
- Access OmniFocus perspectives
- Review items in your OmniFocus database
- Real-time updates through bidirectional communication
Prerequisites
- Node.js v16 or higher
- OmniFocus 4 for Mac (Pro Edition)
- Claude Desktop
Installation
# Clone the repository
git clone https://github.com/yourusername/omnifocus_mcp.git
cd omnifocus_mcp
# Install dependencies
npm install
# Build the project
npm run build
# Register with Claude Desktop
npm run register
Usage
Once installed and registered, you can use Claude Desktop to interact with OmniFocus through natural language. For example:
- "Create a new task called 'Buy groceries' due tomorrow"
- "Show me all my flagged tasks"
- "What projects are due this week?"
- "Mark 'Finish presentation' as complete"
Development
# Run in development mode
npm run dev
# Run tests
npm test
# Lint code
npm run lint
# Package as executable
npm run package
Architecture
The OmniFocus MCP implementation consists of five main components:
- CLI Entry Point: Handles command-line arguments and configuration
- MCP Server: Implements the Model Context Protocol
- OmniJS Bridge: Interfaces with OmniFocus using AppleScript/OmniJS
- Data Models: Define TypeScript interfaces for OmniFocus entities
- Event Management: Enables bidirectional communication
License
ISC
Acknowledgements
- The Omni Group for OmniFocus and OmniJS
- Anthropic for Claude and the Model Context Protocol