OmniFocus MCP

一个实现了模型上下文协议（MCP）的项目，它将Claude Desktop与OmniFocus 4连接起来，通过AI实现自然语言任务管理。

概述

OmniFocus MCP充当了Claude Desktop和OmniFocus 4之间的桥梁，允许您通过自然语言与您的任务、项目和标签进行交互。它实现了模型上下文协议（MCP），使Claude能够与外部应用程序集成。

功能

• 在OmniFocus中创建、读取、更新和删除任务
• 管理项目和标签
• 访问OmniFocus视图
• 查看OmniFocus数据库中的条目
• 通过双向通信实现实时更新

前提条件

• Node.js v16或更高版本
• OmniFocus 4 for Mac (专业版)
• Claude Desktop

安装

bash

克隆仓库

git clone https://github.com/yourusername/omnifocus_mcp.git
cd omnifocus_mcp

安装依赖

npm install

构建项目

npm run build

向Claude Desktop注册

npm run register

使用方法

安装并注册后，您可以使用Claude Desktop通过自然语言与OmniFocus进行交互。例如：

• "创建一个名为'买杂货'的新任务，截止日期为明天"
• "显示我所有标记的任务"
• "本周有哪些项目到期？"
• "将'完成演示文稿'标记为已完成"

开发

bash

以开发模式运行

npm run dev

运行测试

npm test

代码检查

npm run lint

打包成可执行文件

npm run package

架构

OmniFocus MCP实现由五个主要组件组成：

1. CLI入口点：处理命令行参数和配置
2. MCP服务器：实现模型上下文协议
3. OmniJS桥接器：使用AppleScript/OmniJS与OmniFocus接口
4. 数据模型：定义用于OmniFocus实体的TypeScript接口
5. 事件管理：启用双向通信

许可证

ISC

致谢

• The Omni Group 提供了OmniFocus和OmniJS
• Anthropic 提供了Claude和模型上下文协议