Required for running OmniFocus, which is a macOS-only application.
Required runtime environment (v18+) for the MCP server.
Used for package distribution and installation of the OmniFocus MCP server.
๐ OmniFocus MCP Enhanced
๐ NEW: Native Custom Perspective Access with Hierarchical Display!
Transform OmniFocus into an AI-powered productivity powerhouse with custom perspective support
Enhanced Model Context Protocol (MCP) server for OmniFocus featuring native custom perspective access, hierarchical task display, AI-optimized tool selection, and comprehensive task management. Perfect integration with Claude AI for intelligent workflows.
โจ Key Features
๐ NEW: Native Custom Perspective Access
๐ฏ Direct Integration - Native access to your OmniFocus custom perspectives via
Perspective.Custom
API๐ณ Hierarchical Display - Tree-style task visualization with parent-child relationships
๐ง AI-Optimized - Enhanced tool descriptions prevent AI confusion between perspectives and tags
โก Zero Setup - Works with your existing custom perspectives instantly
๐๏ธ Complete Task Management
๐๏ธ Complete Subtask Support - Create hierarchical tasks with parent-child relationships
๐ Built-in Perspectives - Access Inbox, Flagged, Forecast, and Tag-based views
๐ Ultimate Task Filter - Advanced filtering beyond OmniFocus native capabilities
๐ฏ Batch Operations - Add/remove multiple tasks efficiently
๐ Smart Querying - Find tasks by ID, name, or complex criteria
๐ Full CRUD Operations - Create, read, update, delete tasks and projects
๐ Time Management - Due dates, defer dates, estimates, and scheduling
๐ท๏ธ Advanced Tagging - Tag-based filtering with exact/partial matching
๐ค AI Integration - Seamless Claude AI integration for intelligent workflows
๐ฆ Installation
Quick Install (Recommended)
Alternative Installation Methods
๐ Requirements
macOS 10.15+ - OmniFocus is macOS-only
OmniFocus 3+ - The application must be installed and running
OmniFocus Pro - Required for custom perspectives (new features in v1.6.0)
Node.js 18+ - For running the MCP server
Claude Code - For MCP integration
๐ฏ Core Capabilities
1. ๐๏ธ Subtask Management
Create complex task hierarchies with ease:
2. ๐ Perspective Views
Access all major OmniFocus perspectives programmatically:
3. ๐ Ultimate Task Filter
Create any perspective imaginable with advanced filtering:
4. ๐ NEW: Native Custom Perspective Access
Access your OmniFocus custom perspectives with hierarchical task display:
Why This Is Powerful:
โ Native Integration - Uses OmniFocus
Perspective.Custom
API directlyโ Tree Structure - Visual parent-child task relationships with โโ, โโ symbols
โ AI-Friendly - Enhanced descriptions prevent tool selection confusion
โ Professional Output - Clean, readable task hierarchies
5. ๐ฏ Batch Operations
Efficiently manage multiple tasks:
๐ ๏ธ Complete Tool Reference
๐ Database & Task Management
dump_database - Get OmniFocus database state
add_omnifocus_task - Create tasks (enhanced with subtask support)
add_project - Create projects
remove_item - Delete tasks or projects
edit_item - Edit tasks or projects
batch_add_items - Bulk add (enhanced with subtask support)
batch_remove_items - Bulk remove
get_task_by_id - Query task information
๐ Built-in Perspective Tools
get_inbox_tasks - Inbox perspective
get_flagged_tasks - Flagged perspective
get_forecast_tasks - Forecast perspective (due/deferred tasks)
get_tasks_by_tag - Tag-based filtering
filter_tasks - Ultimate filtering with unlimited combinations
๐ Custom Perspective Tools (NEW)
list_custom_perspectives - ๐ NEW: List all custom perspectives with details
get_custom_perspective_tasks - ๐ NEW: Access custom perspective with hierarchical display
๐ Analytics & Tracking
get_today_completed_tasks - View today's completed tasks
๐ Quick Start Examples
Basic Task Creation
Advanced Task Management
Smart Task Discovery
๐ Custom Perspective Usage
๐ง Configuration
Verify Installation
Troubleshooting
Ensure OmniFocus 3+ is installed and running
Verify Node.js 18+ is installed
Check Claude Code MCP configuration
Enable accessibility permissions for terminal apps if needed
๐ฏ Use Cases
Project Management - Create detailed project hierarchies with subtasks
GTD Workflow - Leverage perspectives for Getting Things Done methodology
Time Blocking - Filter by estimated time for schedule planning
Review Process - Use custom perspectives for weekly/monthly reviews
Team Coordination - Batch operations for team task assignment
AI-Powered Planning - Let Claude analyze and organize your tasks
๐ Performance
Fast Filtering - Native AppleScript performance
Batch Efficiency - Single operation for multiple tasks
Memory Optimized - Minimal resource usage
Scalable - Handles large task databases efficiently
๐ค Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
๐ License
MIT License - see LICENSE file for details.
๐ Links
NPM Package: https://www.npmjs.com/package/omnifocus-mcp-enhanced
GitHub Repository: https://github.com/jqlts1/omnifocus-mcp-enhanced
OmniFocus: https://www.omnigroup.com/omnifocus/
Model Context Protocol: https://modelcontextprotocol.io/
Claude Code: https://docs.anthropic.com/en/docs/claude-code
๐ Acknowledgments
Based on the original OmniFocus MCP server by themotionmachine. Enhanced with perspective views, advanced filtering, and complete subtask support.
โญ Star this repo if it helps boost your productivity!
Tools
Enhanced Model Context Protocol server that transforms OmniFocus into an AI-powered productivity tool with comprehensive task management capabilities including subtask support, perspective views, advanced filtering, and custom perspective access.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol (MCP) server that integrates with OmniFocus to enable Claude (or other MCP-compatible AI assistants) to interact with your tasks and projects.Last updated -73291
- AsecurityAlicenseAqualityA Model Context Protocol server providing AI assistants with comprehensive project, task, and subtask management capabilities with project-specific storage.Last updated -2933363MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that integrates OmniFocus with Claude Desktop, providing AI-powered access to tasks and projects for enhanced task management and weekly reviews.Last updated -4324MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables automation and management of OmniFocus tasks, projects, and tags using natural language and programmable interfaces from VS Code, command line, or any MCP-compatible client.Last updated -12MIT License