AI导哈

任务管理服务器

OmniFocus Operator是一个生产级的MCP服务器，将OmniFocus作为结构化任务基础设施暴露给AI代理使用，具有SQLite缓存性能和代理优先设计。

  • by HelloThisIsFlo
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 HelloThisIsFlo/omnifocus-operator

使用说明

🎯 OmniFocus运营商

您需要的最后一台OmniFocus MCP服务器。

生产级MCP服务器将OmniFocus作为AI代理的结构化任务基础设施。代理优先设计，SQLite缓存性能，2561次测试。

→ 查看完整登录页面 --功能、架构、基准测试和比较

🚀 快速开始

先决条件： macOS、OmniFocus 4、Python 3.12+

🪄 不确定此配置的位置？ 这 设置向导 在登录页面上，逐步引导您完成它，包括与现有配置自动合并。

适用于克劳德桌面

将此粘贴到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "omnifocus-operator": {
      "command": "uvx",
      "args": ["omnifocus-operator"]
    }
  }
}

uvx 自动下载、隔离和运行服务器。无安装步骤。

第一轮： OmniFocus显示一次性权限对话框。勾选框，单击 运行脚本你不会再看到它了。

对于Claude代码、OpenCode、游标…

询问您的代理人——复制以下提示：

将此MCP服务器添加到我的客户端配置中。只需编辑配置文件——不要安装任何东西，不要运行任何脚本。

"omnifocus-operator": {
  "command": "uvx",
  "args": ["omnifocus-operator"]
}

⚠️ 这不适用于Claude Desktop——Desktop没有配置编辑工具。使用上面的手动粘贴。

Development install (contributors) 
git clone https://github.com/HelloThisIsFlo/omnifocus-operator.git
cd omnifocus-operator
uv sync

看 贡献.md 了解开发工作流程的详细信息。

✨ 特性

  • ⚡ 46毫秒读取 --SQLite缓存的读取速度比仅桥接服务器快30-60倍
  • 🛠️ 11个MCP工具 --查找、筛选列表、任务创建和编辑
  • 🤖 代理优先设计 --教育的警告，教育的错误，每次回应的指导
  • 🧪 2561次测试，97%的覆盖率 --严格要求，不偷工减料
  • 🛡️ 优雅降级 --服务器无论如何都保持活动状态，始终可恢复
  • 🔄 自动回退 --SQLite→ 需要时使用OmniJS桥

请参阅 全部文件 了解架构细节、示例和深入了解。

🛠️ 可用工具

查询

工具 说明
get_all 作为结构化数据的完整OmniFocus数据库（最后手段调试）
get_task 按ID列出的单个任务——紧急程度、可用性、日期、标签、父任务、项目
get_project 按ID列出的单个项目——状态、审查间隔、下一个任务
get_tag 按ID的单个标记--可用性、父层次结构

列表和筛选器

工具 说明
list_tasks 按日期、可用性、标志、标签、项目、父子树、搜索进行筛选，包括分页、字段选择和状态标志派生
list_projects 按状态、文件夹、审核计划、标记进行筛选
list_tags 列出具有父层次结构的标签
list_folders 列出具有父层次结构的文件夹
list_perspectives 列出自定义透视图

写

工具 说明
add_tasks 创建具有完整字段控制的任务——父项、标签、日期、标志、注释、重复规则、并行/顺序、使用子项完成
edit_tasks 补丁语义——更新字段、移动任务、完成/删除、管理标签、重复规则和层次结构属性

所有的读取工具都是幂等的。按名称或ID编写工具参考项目和标签。

🔍 工具示例

筛选任务 (list_tasks):

{
  "query": {
    "flagged": true,
    "due": "soon",
    "availability": "remaining",
    "include": ["notes"],
    "limit": 10
  }
}

任务 (add_tasks):

{
  "items": [{
    "name": "Review Q3 roadmap",
    "parent": "Work Projects",
    "tags": ["Planning"],
    "dueDate": "2026-03-15T17:00:00",
    "flagged": true,
    "estimatedMinutes": 30,
    "note": "Focus on v1.3-v1.5 milestones"
  }]
}

使用补丁语义进行编辑 (edit_tasks):

{
  "items": [{
    "id": "oRx3bL_UYq7",
    "dueDate": null,
    "actions": {
      "tags": {"add": ["Urgent"]},
      "move": {"ending": "Work Projects"}
    }
  }]
}

补丁语义备忘单：

输入 含义
字段省略 无更改
字段设置为 null 清除该值
字段设置为值 更新

🗺️ 路线图

版本 焦点
v1.0 基础——读取工具、三层拱、测试套件✅
v1.1 性能——SQLite缓存，速度提高30-60倍✅
v1.2 写入和查找--添加/编辑任务，按ID获取✅
v1.2.1 架构清理——契约、服务重构、黄金大师测试✅
v1.2.2 FastMCP v3迁移✅
v1.2.3 重复规则写入支持✅
v1.3 阅读工具——SQL过滤、列表/计数、5个新工具✅
v1.3.1 一级引用——名称解析， $inbox，丰富的参考文献✅
v1.3.2 日期筛选——7个维度、快捷方式、日历数学✅
v1.3.3 任务排序——虚线表示法、大纲顺序✅
v1.4 响应整形和批处理✅
v1.4.1 任务属性和子树——存在标志、自动完成、并行/顺序、父过滤器✅
v1.4.2 直到格式修补程序——解析器接受RFC 5545 DATE格式；构建器与OmniFocus UI保持一致✅
v1.4.3 First Run UX——欢迎横幅 bridge.js 该框架为OmniFocus的权限对话框提供了两个点击指令；启动日志行✅
v1.4.4 批量限制增加-- add_tasks / edit_tasks 每次通话最多可接受150件商品✅
v1.5 项目写入--添加/编辑项目，审阅标记
v1.6 UI和视角——视角切换、深度链接
v1.7 智能透视内容——感知透视的响应形状
v1.8 生产强化——重试、崩溃恢复、串行执行

🔗 链接

📄 许可证

专有——保留所有权利。免费使用，不重新分发。许可证正在审查中。

🤝 贡献

看 贡献.md 作为指导方针。简而言之：分叉、分支、测试、PR。

相关 MCP