Omnifocus MCP

🚀 OmniFocus MCP 服務器

OmniFocus MCP 服務器是一個與 OmniFocus 集成的模型上下文協議（MCP）服務器，它讓 Claude（或其他與 MCP 兼容的 AI 助手）能夠通過自然語言對話與 OmniFocus 中的任務和項目進行交互，極大地提升了任務管理的效率和便捷性。

🚀 快速開始

先決條件

• 需使用安裝了 OmniFocus 的 macOS 系統。

連接到 Claude

1. 在 Claude Desktop 中，將此 MCP 服務器添加到配置文件中：

~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加以下配置：

{
  "mcpServers": {
    "omnifocus": {
      "command": "npx",
      "args": ["-y", "omnifocus-mcp"]
    }
  }
}

3. 啟動 Claude 並連接到新的 OmniFocus MCP 服務器。

✨ 主要特性

此 MCP 服務器在 AI 助手（如 Claude）和您的 OmniFocus 任務管理系統之間架起一座橋樑。它賦予 AI 模型查看、創建、編輯和刪除 OmniFocus 數據庫中的任務和項目的權限。以下是一些具體的使用方法：

• 將課程大綱 PDF 轉換為包含具體任務、標籤、推遲日期和截止日期的完整項目。
• 將會議記錄轉換為操作列表。
• 在 OmniFocus 中創建任務、項目和標籤的可視化。
• 一次性處理多個任務或項目。
• 高效批量管理您的 OmniFocus 項目。

📦 安裝指南

基本工具

# 安裝 npm 包（如果需要）
npm install -g @omnifocus/mcp-server

啟動服務器

omni-mcp-server

💻 使用示例

基礎用法

1. 添加任務

{
  "command": "add_task",
  "params": {
    "name": "完成項目報告",
    "dueDate": "2024-03-25T17:00:00Z",
    "projectName": "工作"
  }
}

2. 獲取所有項目

{
  "command": "get_projects"
}

高級用法

工具列表

• add_task：添加新任務到指定項目。
• add_project：創建新項目並添加到 OmniFocus 數據庫。
• delete_task：根據 ID 刪除特定任務。
• complete_task：完成並標記任務為已完成。
• update_task：更新現有任務的屬性。
• search：搜索數據庫中的任務和項目。
• export_data：導出 OmniFocus 數據到 JSON 文件。

🔧 技術細節

該服務器使用 AppleScript 與 OmniFocus 通信，允許其訪問應用程序的本機功能。服務器使用模型上下文協議（MCP）SDK 構建，提供了一種標準化方式供 AI 模型與其外部工具和系統互動。

開發指南

安裝依賴項

npm install @omnifocus/mcp-server

啟動開發服務器

npx mcp-server start

調試模式

DEBUG=omni-mcp-server npm start

更多信息

• 官方文檔：瞭解詳細開發文檔和 API 參考。
• 問題反饋：提交錯誤或功能請求。

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

歡迎貢獻！請隨時提交 Pull Request。