OmniFocus MCP 服务器

一个模型上下文协议 (MCP) 服务器，它与 OmniFocus 集成，使 Claude（或其他 MCP 兼容的 AI 助手）能够与您的任务和项目进行交互。

🌟 概述

此 MCP 服务器在 AI 助手（如 Claude）和您的 OmniFocus 任务管理系统之间创建桥梁。它使 AI 模型能够通过自然语言对话查看、创建、编辑和删除 OmniFocus 数据库中的任务和项目。 您可以使用它的几种方式：

• 将教学大纲的 PDF 翻译成具有任务、标签、延期日期和截止日期的完全指定的项目。
• 将会议记录转换为行动列表
• 创建任务、项目和标签的可视化效果

🚀 快速开始

前提条件

• 安装了 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 Desktop

🌈 使用案例

重新组织您的项目、任务和标签

"我希望每个任务都有一个能量级别标签。向我展示所有没有能量级别标签的任务列表，以及您关于添加什么标签的建议。我会做出我认为合适的任何更改。然后在 OmniFocus 中进行更改。"

从任何对话中添加任务

"好的，谢谢你详细解释了为什么法治很重要。在我的行动主义项目中添加一个重复性任务，提醒我每周给我的代表打电话。在备注字段中包含本次对话的摘要。"

快速、虚拟的透视图

获取当前任务的摘要并以对话方式管理它们：

"向我展示本周到期的所有已标记任务，这些任务没有提到“鱼”。"

处理记录或 PDF

从会议记录、学术研究文章或笔记中提取行动项：

"我正在粘贴今天产品会议的记录。请分析它并在 OmniFocus 中为分配给我的任何行动项创建任务。将它们放在我的“产品开发”项目中。"

🔧 可用工具

该服务器目前提供以下工具：

dump_database

获取 OmniFocus 数据库的当前状态。

add_omnifocus_task

向 OmniFocus 添加新任务。

参数：

• name：任务的名称
• projectName：（可选）要将任务添加到的项目的名称
• note：（可选）任务的其他说明
• dueDate：（可选）任务的截止日期，采用 ISO 格式
• deferDate：（可选）任务的延期日期，采用 ISO 格式
• flagged：（可选）任务是否已标记
• estimatedMinutes：（可选）完成任务的预计时间
• tags：（可选）要分配给任务的标签

add_project

向 OmniFocus 添加新项目。

参数：

• name：项目的名称
• folderName：（可选）要将项目添加到的文件夹的名称
• note：（可选）项目的其他说明
• dueDate：（可选）项目的截止日期，采用 ISO 格式
• deferDate：（可选）项目的延期日期，采用 ISO 格式
• flagged：（可选）项目是否已标记
• estimatedMinutes：（可选）完成项目的预计时间
• tags：（可选）要分配给项目的标签
• sequential：（可选）项目中的任务是否应按顺序执行

remove_item

从 OmniFocus 中删除任务或项目。

参数：

• id：（可选）要删除的任务或项目的 ID
• name：（可选）要删除的任务或项目的名称
• itemType：要删除的项目的类型（“task”或“project”）

edit_item

编辑 OmniFocus 中的任务或项目。

参数：

• id：（可选）要编辑的任务或项目的 ID
• name：（可选）要编辑的任务或项目的名称
• itemType：要编辑的项目的类型（“task”或“project”）
• 用于编辑属性的各种参数

🛠 开发

文档待定。

🧠 工作原理

此服务器使用 AppleScript 与 OmniFocus 通信，使其能够与应用程序的本机功能进行交互。该服务器使用模型上下文协议 SDK 构建，该 SDK 提供了一种标准化的方式，供 AI 模型与外部工具和系统进行交互。

📜 许可证

MIT

🤝 贡献

欢迎贡献！请随时提交 Pull Request。