JinDaGe - OmniFocus-MCP MCP Details

article

README

🚀 OmniFocus MCP 服务器

OmniFocus MCP 服务器是一个与 OmniFocus 集成的模型上下文协议 (MCP) 服务器，它能让 Claude（或其他与 MCP 兼容的 AI 助手）通过自然语言对话与 OmniFocus 中的任务和项目进行互动，极大提升任务管理效率。

🚀 快速开始

先决条件

需使用安装了 OmniFocus 的 macOS 系统。

连接到 Claude

在 Claude Desktop 里，将此 MCP 服务器添加到配置文件中：

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

添加如下配置：

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

启动 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

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献

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

OmniFocus-MCP