Skip to main content
Glama

OmniFocus MCP Enhanced

by jqlts1
npmGitHub
TypeScript
5
10
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

๐Ÿš€ OmniFocus MCP Enhanced

npm version License: MIT Node.js CI macOS

๐ŸŒŸ 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)

# One-line installation claude mcp add omnifocus-enhanced -- npx -y omnifocus-mcp-enhanced

Alternative Installation Methods

# Global installation npm install -g omnifocus-mcp-enhanced claude mcp add omnifocus-enhanced -- omnifocus-mcp-enhanced # Local project installation git clone https://github.com/jqlts1/omnifocus-mcp-enhanced.git cd omnifocus-mcp-enhanced npm install && npm run build claude mcp add omnifocus-enhanced -- node "/path/to/omnifocus-mcp-enhanced/dist/server.js"

๐Ÿ“‹ 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:

// Create subtask by parent task name { "name": "Analyze competitor keywords", "parentTaskName": "SEO Strategy", "note": "Focus on top 10 competitors", "dueDate": "2025-01-15", "estimatedMinutes": 120, "tags": ["SEO", "Research"] } // Create subtask by parent task ID { "name": "Write content outline", "parentTaskId": "loK2xEAY4H1", "flagged": true, "estimatedMinutes": 60 }

2. ๐Ÿ” Perspective Views

Access all major OmniFocus perspectives programmatically:

# Inbox perspective get_inbox_tasks {"hideCompleted": true} # Flagged tasks get_flagged_tasks {"projectFilter": "SEO Project"} # Forecast (next 7 days) get_forecast_tasks {"days": 7, "hideCompleted": true} # Tasks by tag get_tasks_by_tag {"tagName": "AI", "exactMatch": false}

3. ๐Ÿš€ Ultimate Task Filter

Create any perspective imaginable with advanced filtering:

# Time management view (30min tasks due this week) filter_tasks { "taskStatus": ["Available", "Next"], "estimateMax": 30, "dueThisWeek": true } # Deep work view (60+ minute tasks with notes) filter_tasks { "estimateMin": 60, "hasNote": true, "taskStatus": ["Available"] } # Project overdue tasks filter_tasks { "projectFilter": "Website Redesign", "taskStatus": ["Overdue", "DueSoon"] }

4. ๐ŸŒŸ NEW: Native Custom Perspective Access

Access your OmniFocus custom perspectives with hierarchical task display:

# ๐ŸŒŸ NEW: List all your custom perspectives list_custom_perspectives {"format": "detailed"} # ๐ŸŒณ NEW: Get tasks from custom perspective with tree display get_custom_perspective_tasks { "perspectiveName": "ไปŠๆ—ฅๅทฅไฝœๅฎ‰ๆŽ’", # Your custom perspective name "showHierarchy": true, # Enable tree display "hideCompleted": true } # Examples with different perspectives get_custom_perspective_tasks { "perspectiveName": "Today Review", "showHierarchy": true } get_custom_perspective_tasks { "perspectiveName": "Weekly Planning", "showHierarchy": false # Flat 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:

{ "items": [ { "type": "task", "name": "Website Technical SEO", "projectName": "SEO Project", "note": "Optimize technical aspects" }, { "type": "task", "name": "Page Speed Optimization", "parentTaskName": "Website Technical SEO", "estimatedMinutes": 180, "flagged": true }, { "type": "task", "name": "Mobile Responsiveness", "parentTaskName": "Website Technical SEO", "estimatedMinutes": 90 } ] }

๐Ÿ› ๏ธ Complete Tool Reference

๐Ÿ“Š Database & Task Management

  1. dump_database - Get OmniFocus database state

  2. add_omnifocus_task - Create tasks (enhanced with subtask support)

  3. add_project - Create projects

  4. remove_item - Delete tasks or projects

  5. edit_item - Edit tasks or projects

  6. batch_add_items - Bulk add (enhanced with subtask support)

  7. batch_remove_items - Bulk remove

  8. get_task_by_id - Query task information

๐Ÿ” Built-in Perspective Tools

  1. get_inbox_tasks - Inbox perspective

  2. get_flagged_tasks - Flagged perspective

  3. get_forecast_tasks - Forecast perspective (due/deferred tasks)

  4. get_tasks_by_tag - Tag-based filtering

  5. filter_tasks - Ultimate filtering with unlimited combinations

๐ŸŒŸ Custom Perspective Tools (NEW)

  1. list_custom_perspectives - ๐ŸŒŸ NEW: List all custom perspectives with details

  2. get_custom_perspective_tasks - ๐ŸŒŸ NEW: Access custom perspective with hierarchical display

๐Ÿ“Š Analytics & Tracking

  1. get_today_completed_tasks - View today's completed tasks

๐Ÿš€ Quick Start Examples

Basic Task Creation

# Simple task add_omnifocus_task { "name": "Review quarterly goals", "projectName": "Planning", "dueDate": "2025-01-31" }

Advanced Task Management

# Create parent task add_omnifocus_task { "name": "Launch Product Campaign", "projectName": "Marketing", "dueDate": "2025-02-15", "tags": ["Campaign", "Priority"] } # Add subtasks add_omnifocus_task { "name": "Design landing page", "parentTaskName": "Launch Product Campaign", "estimatedMinutes": 240, "flagged": true }

Smart Task Discovery

# Find high-priority work filter_tasks { "flagged": true, "taskStatus": ["Available"], "estimateMax": 120, "hasEstimate": true } # Today's completed work filter_tasks { "completedToday": true, "taskStatus": ["Completed"], "sortBy": "project" }

๐ŸŒŸ Custom Perspective Usage

# List your custom perspectives list_custom_perspectives {"format": "detailed"} # Access a custom perspective with hierarchy get_custom_perspective_tasks { "perspectiveName": "Today Review", "showHierarchy": true, "hideCompleted": true } # Quick flat view of weekly planning get_custom_perspective_tasks { "perspectiveName": "Weekly Planning", "showHierarchy": false }

๐Ÿ”ง Configuration

Verify Installation

# Check MCP status claude mcp list # Test basic connection get_inbox_tasks # Test new custom perspective features list_custom_perspectives

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.

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. Submit a pull request

๐Ÿ“„ License

MIT License - see LICENSE file for details.

๐Ÿ”— Links

๐Ÿ™ 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!

Deploy Server
A
security โ€“ no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Tools

View all 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.

  1. โœจ Key Features
    1. ๐ŸŒŸ NEW: Native Custom Perspective Access
    2. ๐Ÿ—๏ธ Complete Task Management
  2. ๐Ÿ“ฆ Installation
    1. Quick Install (Recommended)
    2. Alternative Installation Methods
  3. ๐Ÿ“‹ Requirements
    1. ๐ŸŽฏ Core Capabilities
      1. 1. ๐Ÿ—๏ธ Subtask Management
      2. 2. ๐Ÿ” Perspective Views
      3. 3. ๐Ÿš€ Ultimate Task Filter
      4. 4. ๐ŸŒŸ NEW: Native Custom Perspective Access
      5. 5. ๐ŸŽฏ Batch Operations
    2. ๐Ÿ› ๏ธ Complete Tool Reference
      1. ๐Ÿ“Š Database & Task Management
      2. ๐Ÿ” Built-in Perspective Tools
      3. ๐ŸŒŸ Custom Perspective Tools (NEW)
      4. ๐Ÿ“Š Analytics & Tracking
    3. ๐Ÿš€ Quick Start Examples
      1. Basic Task Creation
      2. Advanced Task Management
      3. Smart Task Discovery
      4. ๐ŸŒŸ Custom Perspective Usage
    4. ๐Ÿ”ง Configuration
      1. Verify Installation
      2. Troubleshooting
    5. ๐ŸŽฏ Use Cases
      1. ๐Ÿ“ˆ Performance
        1. ๐Ÿค Contributing
          1. ๐Ÿ“„ License
            1. ๐Ÿ”— Links
              1. ๐Ÿ™ Acknowledgments

                Related MCP Servers

                • OmniFocus-MCP

                  themotionmachine
                  A
                  security
                  F
                  license
                  A
                  quality
                  A 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 -
                  7
                  32
                  91
                  • Apple

                • Agentic Tools MCP Server

                  Pimzino
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server providing AI assistants with comprehensive project, task, and subtask management capabilities with project-specific storage.
                  Last updated -
                  29
                  333
                  63
                  MIT License
                  • Apple
                  • Linux

                • OmniFocus MCP Server

                  mdoel
                  A
                  security
                  A
                  license
                  A
                  quality
                  A 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 -
                  4
                  32
                  4
                  MIT License
                  • Apple

                • MCP OmniFocus

                  someposer
                  A
                  security
                  A
                  license
                  A
                  quality
                  A 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 -
                  12
                  MIT License
                  • Apple

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/jqlts1/omnifocus-mcp-enhanced'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server