Omnifocus MCP Enhanced

🚀 OmniFocus MCP 增强版

OmniFocus MCP 增强版是一个强大的工具，它能将 OmniFocus 转变为一个由人工智能驱动的生产力引擎，支持自定义视角，为用户带来更高效的任务管理体验。

🌟 新特性：支持原生自定义视角访问与分层显示！

借助自定义视角支持，将 OmniFocus 转变为人工智能驱动的生产力利器

这是一个为 OmniFocus 打造的增强型模型上下文协议（MCP）服务器，具备原生自定义视角访问、分层任务显示、人工智能优化的工具选择以及全面的任务管理功能。它与 Claude AI 完美集成，可实现智能工作流程。

✨ 主要特性

🌟 新特性：原生自定义视角访问

• 🎯 直接集成 - 通过 Perspective.Custom API 原生访问您的 OmniFocus 自定义视角。
• 🌳 分层显示 - 以树形结构可视化任务的父子关系。
• 🧠 人工智能优化 - 增强的工具描述可避免人工智能在视角和标签之间产生混淆。
• ⚡ 零设置 - 可立即与您现有的自定义视角配合使用。

🏗️ 全面的任务管理

• 🏗️ 完整的子任务支持 - 创建具有父子关系的分层任务。
• 🔍 内置视角 - 访问收件箱、标记、预测和基于标签的视图。
• 🚀 终极任务过滤器 - 具备超越 OmniFocus 原生功能的高级过滤能力。
• 🎯 批量操作 - 高效地添加/删除多个任务。
• 📊 智能查询 - 按 ID、名称或复杂条件查找任务。
• 🔄 完整的 CRUD 操作 - 创建、读取、更新和删除任务及项目。
• 📅 时间管理 - 支持截止日期、推迟日期、估计时间和日程安排。
• 🏷️ 高级标签 - 支持精确/部分匹配的基于标签的过滤。
• 🤖 人工智能集成 - 与 Claude AI 无缝集成，实现智能工作流程。

📦 安装指南

快速安装（推荐）

# 一键安装
claude mcp add omnifocus-enhanced -- npx -y omnifocus-mcp-enhanced

其他安装方法

# 全局安装
npm install -g omnifocus-mcp-enhanced
claude mcp add omnifocus-enhanced -- omnifocus-mcp-enhanced

# 本地项目安装
git clone https://github.com/jqlts1/omnifocus-mcp-enhanced.git
cd omnifocus-mcp-enhanced
npm install && npm run build
claude mcp add omnifocus-enhanced -- node "/path/to/omnifocus-mcp-enhanced/dist/server.js"

📋 要求

• macOS 10.15+ - 因为 OmniFocus 仅支持 macOS 系统。
• OmniFocus 3+ - 必须安装并运行该应用程序。
• OmniFocus Pro - 自定义视角功能（v1.6.0 中的新特性）需要此版本。
• Node.js 18+ - 用于运行 MCP 服务器。
• Claude Code - 用于 MCP 集成。

💻 使用示例

基础用法

子任务管理

轻松创建复杂的任务层次结构：

// 通过父任务名称创建子任务
{
  "name": "Analyze competitor keywords",
  "parentTaskName": "SEO Strategy",
  "note": "Focus on top 10 competitors",
  "dueDate": "2025-01-15",
  "estimatedMinutes": 120,
  "tags": ["SEO", "Research"]
}

// 通过父任务 ID 创建子任务
{
  "name": "Write content outline",
  "parentTaskId": "loK2xEAY4H1",
  "flagged": true,
  "estimatedMinutes": 60
}

视角视图

以编程方式访问所有主要的 OmniFocus 视角：

# 收件箱视角
get_inbox_tasks {"hideCompleted": true}

# 标记任务
get_flagged_tasks {"projectFilter": "SEO Project"}

# 预测（未来 7 天）
get_forecast_tasks {"days": 7, "hideCompleted": true}

# 按标签查找任务
get_tasks_by_tag {"tagName": "AI", "exactMatch": false}

高级用法

终极任务过滤器

使用高级过滤功能创建任何可想象的视角：

# 时间管理视图（本周到期的 30 分钟任务）
filter_tasks {
  "taskStatus": ["Available", "Next"],
  "estimateMax": 30,
  "dueThisWeek": true
}

# 深度工作视图（有备注的 60 分钟以上任务）
filter_tasks {
  "estimateMin": 60,
  "hasNote": true,
  "taskStatus": ["Available"]
}

# 项目逾期任务
filter_tasks {
  "projectFilter": "Website Redesign",
  "taskStatus": ["Overdue", "DueSoon"]
}

🌟 新特性：原生自定义视角访问

访问您的 OmniFocus 自定义视角并进行分层任务显示：

# 🌟 新特性：列出所有自定义视角
list_custom_perspectives {"format": "detailed"}

# 🌳 新特性：以树形显示从自定义视角获取任务
get_custom_perspective_tasks {
  "perspectiveName": "今日工作安排",  # 您的自定义视角名称
  "showHierarchy": true,            # 启用树形显示
  "hideCompleted": true
}

# 不同视角的示例
get_custom_perspective_tasks {
  "perspectiveName": "Today Review",
  "showHierarchy": true
}

get_custom_perspective_tasks {
  "perspectiveName": "Weekly Planning",
  "showHierarchy": false  # 平面显示
}

为何此功能强大：

• ✅ 原生集成 - 直接使用 OmniFocus Perspective.Custom API。
• ✅ 树形结构 - 使用 ├─、└─ 符号直观显示任务的父子关系。
• ✅ 人工智能友好 - 增强的描述可避免工具选择时的混淆。
• ✅ 专业输出 - 干净、易读的任务层次结构。

批量操作

高效管理多个任务：

{
  "items": [
    {
      "type": "task",
      "name": "Website Technical SEO",
      "projectName": "SEO Project",
      "note": "Optimize technical aspects"
    },
    {
      "type": "task",
      "name": "Page Speed Optimization",
      "parentTaskName": "Website Technical SEO",
      "estimatedMinutes": 180,
      "flagged": true
    },
    {
      "type": "task",
      "name": "Mobile Responsiveness",
      "parentTaskName": "Website Technical SEO",
      "estimatedMinutes": 90
    }
  ]
}

🛠️ 完整工具参考

📊 数据库与任务管理

1. dump_database - 获取 OmniFocus 数据库状态。
2. add_omnifocus_task - 创建任务（增强了子任务支持）。
3. add_project - 创建项目。
4. remove_item - 删除任务或项目。
5. edit_item - 编辑任务或项目。
6. batch_add_items - 批量添加（增强了子任务支持）。
7. batch_remove_items - 批量删除。
8. get_task_by_id - 查询任务信息。

🔍 内置视角工具

9. get_inbox_tasks - 收件箱视角。
10. get_flagged_tasks - 标记视角。
11. get_forecast_tasks - 预测视角（到期/推迟任务）。
12. get_tasks_by_tag - 基于标签的过滤。
13. filter_tasks - 具备无限组合的终极过滤功能。

🌟 自定义视角工具（新特性）

14. list_custom_perspectives - 🌟 新特性：详细列出所有自定义视角。
15. get_custom_perspective_tasks - 🌟 新特性：以分层显示方式访问自定义视角。

📊 分析与跟踪

16. get_today_completed_tasks - 查看今日已完成的任务。

🚀 快速开始示例

基本任务创建

# 简单任务
add_omnifocus_task {
  "name": "Review quarterly goals",
  "projectName": "Planning",
  "dueDate": "2025-01-31"
}

高级任务管理

# 创建父任务
add_omnifocus_task {
  "name": "Launch Product Campaign",
  "projectName": "Marketing",
  "dueDate": "2025-02-15",
  "tags": ["Campaign", "Priority"]
}

# 添加子任务
add_omnifocus_task {
  "name": "Design landing page",
  "parentTaskName": "Launch Product Campaign",
  "estimatedMinutes": 240,
  "flagged": true
}

智能任务发现

# 查找高优先级工作
filter_tasks {
  "flagged": true,
  "taskStatus": ["Available"],
  "estimateMax": 120,
  "hasEstimate": true
}

# 今日已完成的工作
filter_tasks {
  "completedToday": true,
  "taskStatus": ["Completed"],
  "sortBy": "project"
}

🌟 自定义视角使用

# 列出您的自定义视角
list_custom_perspectives {"format": "detailed"}

# 以分层方式访问自定义视角
get_custom_perspective_tasks {
  "perspectiveName": "Today Review",
  "showHierarchy": true,
  "hideCompleted": true
}

# 快速平面查看每周计划
get_custom_perspective_tasks {
  "perspectiveName": "Weekly Planning",
  "showHierarchy": false
}

🔧 配置

验证安装

# 检查 MCP 状态
claude mcp list

# 测试基本连接
get_inbox_tasks

# 测试新的自定义视角功能
list_custom_perspectives

故障排除

• 确保已安装并运行 OmniFocus 3+。
• 验证已安装 Node.js 18+。
• 检查 Claude Code MCP 配置。
• 如有需要，为终端应用程序启用辅助功能权限。

🎯 使用场景

• 项目管理 - 创建包含子任务的详细项目层次结构。
• GTD 工作流程 - 利用视角实现“把事情做完”（GTD）方法。
• 时间块管理 - 按估计时间过滤以进行日程规划。
• 审查流程 - 使用自定义视角进行每周/每月审查。
• 团队协作 - 通过批量操作进行团队任务分配。
• 人工智能驱动的规划 - 让 Claude 分析和组织您的任务。

📈 性能

• 快速过滤 - 具备原生 AppleScript 性能。
• 批量效率 - 单个操作可处理多个任务。
• 内存优化 - 资源占用极少。
• 可扩展性 - 能高效处理大型任务数据库。

🤝 贡献

欢迎贡献代码！请随时提交拉取请求。

1. 分叉仓库。
2. 创建功能分支。
3. 进行更改。
4. 如有必要，添加测试。
5. 提交拉取请求。

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

🔗 链接

• NPM 包：https://www.npmjs.com/package/omnifocus-mcp-enhanced
• GitHub 仓库：https://github.com/jqlts1/omnifocus-mcp-enhanced
• OmniFocus：https://www.omnigroup.com/omnifocus/
• 模型上下文协议：https://modelcontextprotocol.io/
• Claude Code：https://docs.anthropic.com/en/docs/claude-code

🙏 致谢

本项目基于 themotionmachine 开发的原始 OmniFocus MCP 服务器。增强了视角视图、高级过滤和完整的子任务支持功能。

⭐ 如果这个仓库有助于提高您的生产力，请给它加星！