Omnifocus MCP Enhanced

🚀 OmniFocus MCP 增強版

OmniFocus MCP 增強版是一個強大的工具，它能將 OmniFocus 轉變為一個由人工智能驅動的生產力引擎，支持自定義視角，為用戶帶來更高效的任務管理體驗。

🌟 新特性：支持原生自定義視角訪問與分層顯示！

藉助自定義視角支持，將 OmniFocus 轉變為人工智能驅動的生產力利器

這是一個為 OmniFocus 打造的增強型模型上下文協議（MCP）服務器，具備原生自定義視角訪問、分層任務顯示、人工智能優化的工具選擇以及全面的任務管理功能。它與 Claude AI 完美集成，可實現智能工作流程。

✨ 主要特性

🌟 新特性：原生自定義視角訪問

• 🎯 直接集成 - 通過 Perspective.Custom API 原生訪問您的 OmniFocus 自定義視角。
• 🌳 分層顯示 - 以樹形結構可視化任務的父子關係。
• 🧠 人工智能優化 - 增強的工具描述可避免人工智能在視角和標籤之間產生混淆。
• ⚡ 零設置 - 可立即與您現有的自定義視角配合使用。

🏗️ 全面的任務管理

• 🏗️ 完整的子任務支持 - 創建具有父子關係的分層任務。
• 🔍 內置視角 - 訪問收件箱、標記、預測和基於標籤的視圖。
• 🚀 終極任務過濾器 - 具備超越 OmniFocus 原生功能的高級過濾能力。
• 🎯 批量操作 - 高效地添加/刪除多個任務。
• 📊 智能查詢 - 按 ID、名稱或複雜條件查找任務。
• 🔄 完整的 CRUD 操作 - 創建、讀取、更新和刪除任務及項目。
• 📅 時間管理 - 支持截止日期、推遲日期、估計時間和日程安排。
• 🏷️ 高級標籤 - 支持精確/部分匹配的基於標籤的過濾。
• 🤖 人工智能集成 - 與 Claude AI 無縫集成，實現智能工作流程。

📦 安裝指南

快速安裝（推薦）

# 一鍵安裝
claude mcp add omnifocus-enhanced -- npx -y omnifocus-mcp-enhanced

其他安裝方法

# 全局安裝
npm install -g omnifocus-mcp-enhanced
claude mcp add omnifocus-enhanced -- omnifocus-mcp-enhanced

# 本地項目安裝
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"

📋 要求

• macOS 10.15+ - 因為 OmniFocus 僅支持 macOS 系統。
• OmniFocus 3+ - 必須安裝並運行該應用程序。
• OmniFocus Pro - 自定義視角功能（v1.6.0 中的新特性）需要此版本。
• Node.js 18+ - 用於運行 MCP 服務器。
• Claude Code - 用於 MCP 集成。

💻 使用示例

基礎用法

子任務管理

輕鬆創建複雜的任務層次結構：

// 通過父任務名稱創建子任務
{
  "name": "Analyze competitor keywords",
  "parentTaskName": "SEO Strategy",
  "note": "Focus on top 10 competitors",
  "dueDate": "2025-01-15",
  "estimatedMinutes": 120,
  "tags": ["SEO", "Research"]
}

// 通過父任務 ID 創建子任務
{
  "name": "Write content outline",
  "parentTaskId": "loK2xEAY4H1",
  "flagged": true,
  "estimatedMinutes": 60
}

視角視圖

以編程方式訪問所有主要的 OmniFocus 視角：

# 收件箱視角
get_inbox_tasks {"hideCompleted": true}

# 標記任務
get_flagged_tasks {"projectFilter": "SEO Project"}

# 預測（未來 7 天）
get_forecast_tasks {"days": 7, "hideCompleted": true}

# 按標籤查找任務
get_tasks_by_tag {"tagName": "AI", "exactMatch": false}

高級用法

終極任務過濾器

使用高級過濾功能創建任何可想象的視角：

# 時間管理視圖（本週到期的 30 分鐘任務）
filter_tasks {
  "taskStatus": ["Available", "Next"],
  "estimateMax": 30,
  "dueThisWeek": true
}

# 深度工作視圖（有備註的 60 分鐘以上任務）
filter_tasks {
  "estimateMin": 60,
  "hasNote": true,
  "taskStatus": ["Available"]
}

# 項目逾期任務
filter_tasks {
  "projectFilter": "Website Redesign",
  "taskStatus": ["Overdue", "DueSoon"]
}

🌟 新特性：原生自定義視角訪問

訪問您的 OmniFocus 自定義視角並進行分層任務顯示：

# 🌟 新特性：列出所有自定義視角
list_custom_perspectives {"format": "detailed"}

# 🌳 新特性：以樹形顯示從自定義視角獲取任務
get_custom_perspective_tasks {
  "perspectiveName": "今日工作安排",  # 您的自定義視角名稱
  "showHierarchy": true,            # 啟用樹形顯示
  "hideCompleted": true
}

# 不同視角的示例
get_custom_perspective_tasks {
  "perspectiveName": "Today Review",
  "showHierarchy": true
}

get_custom_perspective_tasks {
  "perspectiveName": "Weekly Planning",
  "showHierarchy": false  # 平面顯示
}

為何此功能強大：

• ✅ 原生集成 - 直接使用 OmniFocus Perspective.Custom API。
• ✅ 樹形結構 - 使用 ├─、└─ 符號直觀顯示任務的父子關係。
• ✅ 人工智能友好 - 增強的描述可避免工具選擇時的混淆。
• ✅ 專業輸出 - 乾淨、易讀的任務層次結構。

批量操作

高效管理多個任務：

{
  "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
    }
  ]
}

🛠️ 完整工具參考

📊 數據庫與任務管理

1. dump_database - 獲取 OmniFocus 數據庫狀態。
2. add_omnifocus_task - 創建任務（增強了子任務支持）。
3. add_project - 創建項目。
4. remove_item - 刪除任務或項目。
5. edit_item - 編輯任務或項目。
6. batch_add_items - 批量添加（增強了子任務支持）。
7. batch_remove_items - 批量刪除。
8. get_task_by_id - 查詢任務信息。

🔍 內置視角工具

9. get_inbox_tasks - 收件箱視角。
10. get_flagged_tasks - 標記視角。
11. get_forecast_tasks - 預測視角（到期/推遲任務）。
12. get_tasks_by_tag - 基於標籤的過濾。
13. filter_tasks - 具備無限組合的終極過濾功能。

🌟 自定義視角工具（新特性）

14. list_custom_perspectives - 🌟 新特性：詳細列出所有自定義視角。
15. get_custom_perspective_tasks - 🌟 新特性：以分層顯示方式訪問自定義視角。

📊 分析與跟蹤

16. get_today_completed_tasks - 查看今日已完成的任務。

🚀 快速開始示例

基本任務創建

# 簡單任務
add_omnifocus_task {
  "name": "Review quarterly goals",
  "projectName": "Planning",
  "dueDate": "2025-01-31"
}

高級任務管理

# 創建父任務
add_omnifocus_task {
  "name": "Launch Product Campaign",
  "projectName": "Marketing",
  "dueDate": "2025-02-15",
  "tags": ["Campaign", "Priority"]
}

# 添加子任務
add_omnifocus_task {
  "name": "Design landing page",
  "parentTaskName": "Launch Product Campaign",
  "estimatedMinutes": 240,
  "flagged": true
}

智能任務發現

# 查找高優先級工作
filter_tasks {
  "flagged": true,
  "taskStatus": ["Available"],
  "estimateMax": 120,
  "hasEstimate": true
}

# 今日已完成的工作
filter_tasks {
  "completedToday": true,
  "taskStatus": ["Completed"],
  "sortBy": "project"
}

🌟 自定義視角使用

# 列出您的自定義視角
list_custom_perspectives {"format": "detailed"}

# 以分層方式訪問自定義視角
get_custom_perspective_tasks {
  "perspectiveName": "Today Review",
  "showHierarchy": true,
  "hideCompleted": true
}

# 快速平面查看每週計劃
get_custom_perspective_tasks {
  "perspectiveName": "Weekly Planning",
  "showHierarchy": false
}

🔧 配置

驗證安裝

# 檢查 MCP 狀態
claude mcp list

# 測試基本連接
get_inbox_tasks

# 測試新的自定義視角功能
list_custom_perspectives

故障排除

• 確保已安裝並運行 OmniFocus 3+。
• 驗證已安裝 Node.js 18+。
• 檢查 Claude Code MCP 配置。
• 如有需要，為終端應用程序啟用輔助功能權限。

🎯 使用場景

• 項目管理 - 創建包含子任務的詳細項目層次結構。
• GTD 工作流程 - 利用視角實現“把事情做完”（GTD）方法。
• 時間塊管理 - 按估計時間過濾以進行日程規劃。
• 審查流程 - 使用自定義視角進行每週/每月審查。
• 團隊協作 - 通過批量操作進行團隊任務分配。
• 人工智能驅動的規劃 - 讓 Claude 分析和組織您的任務。

📈 性能

• 快速過濾 - 具備原生 AppleScript 性能。
• 批量效率 - 單個操作可處理多個任務。
• 內存優化 - 資源佔用極少。
• 可擴展性 - 能高效處理大型任務數據庫。

🤝 貢獻

歡迎貢獻代碼！請隨時提交拉取請求。

1. 分叉倉庫。
2. 創建功能分支。
3. 進行更改。
4. 如有必要，添加測試。
5. 提交拉取請求。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

🔗 鏈接

• NPM 包：https://www.npmjs.com/package/omnifocus-mcp-enhanced
• GitHub 倉庫：https://github.com/jqlts1/omnifocus-mcp-enhanced
• OmniFocus：https://www.omnigroup.com/omnifocus/
• 模型上下文協議：https://modelcontextprotocol.io/
• Claude Code：https://docs.anthropic.com/en/docs/claude-code

🙏 致謝

本項目基於 themotionmachine 開發的原始 OmniFocus MCP 服務器。增強了視角視圖、高級過濾和完整的子任務支持功能。

⭐ 如果這個倉庫有助於提高您的生產力，請給它加星！