JinDaGe - omnifocus-mcp-enhanced MCP Details

article

README

🚀 OmniFocus MCP 增强版

OmniFocus MCP 增强版是一个强大的工具，它通过支持自定义视角，将 OmniFocus 转变为一个由人工智能驱动的高效生产力平台。它具备原生自定义视角访问、分层任务显示、AI 优化工具选择和全面的任务管理等功能，还能与 Claude AI 完美集成，实现智能工作流程。

🚀 快速开始

以下是一些快速开始的示例，帮助你了解如何使用 OmniFocus MCP 增强版：

基本任务创建

# 简单任务
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
}

✨ 主要特性

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

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

🏗️ 全面的任务管理

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

📚 详细文档

📊 数据库与任务管理

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

🔍 内置视角工具

get_inbox_tasks：收件箱视角。
get_flagged_tasks：标记视角。
get_forecast_tasks：预测视角（到期/延迟任务）。
get_tasks_by_tag：基于标签的过滤。
filter_tasks：具备无限组合的终极过滤功能。

🌟 自定义视角工具（新增）

list_custom_perspectives：🌟 新增：详细列出所有自定义视角。
get_custom_perspective_tasks：🌟 新增：以分层显示方式访问自定义视角。

📊 分析与跟踪

get_today_completed_tasks：查看今天完成的任务。

🔧 技术细节

验证安装

# 检查 MCP 状态
claude mcp list

# 测试基本连接
get_inbox_tasks

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

故障排除

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

🎯 使用场景

项目管理：创建具有子任务的详细项目层次结构。
GTD 工作流：利用视角实现“搞定一切”（GTD）方法。
时间块管理：按估计时间过滤，进行日程规划。
审核流程：使用自定义视角进行每周/每月审核。
团队协作：通过批量操作进行团队任务分配。
AI 驱动的规划：让 Claude 分析和组织你的任务。

📈 性能

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

🤝 贡献

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

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

📄 许可证

本项目采用 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 服务器。增强了视角视图、高级过滤和完整的子任务支持。

⭐ 如果这个仓库有助于提高你的工作效率，请给它加星！

omnifocus-mcp-enhanced