Omnifocus Operator

🎯 OmniFocus运营商

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


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

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

______________________________________________________________________

🚀 快速开始

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

Claude桌面配置 (~/Library/Application Support/Claude/claude_desktop_config.json):

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

就是这样。无需安装步骤-- uvx 自动下载、隔离和运行服务器。

或者问问你的经纪人：

为我设置OmniFocus Operator MCP服务器--uvx OmniFocus Operators

Development install (contributors)

git clone https://github.com/HelloThisIsFlo/omnifocus-operator.git
cd omnifocus-operator
uv sync

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

______________________________________________________________________

✨ 特性

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

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

______________________________________________________________________

🛠️ 可用工具

查找

列表和筛选器

写

所有的读取工具都是幂等的。按名称或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"}
    }
  }]
}

补丁语义备忘单：

______________________________________________________________________

🗺️ 路线图

______________________________________________________________________

🔗 链接

• 📖 全部文件 --特征、架构、示例
• 📦 PyPI --包裹页面
• 🐛 问题
• 💬 讨论

______________________________________________________________________

📄 许可证

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

🤝 贡献

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