Focus Pocus-OmniFocus MCP服务器
通过全面的任务管理、自然语言数据解析和智能自动化将Claude Desktop连接到OmniFocus。
什么是Focus Pocus？
Focus Pocus是一个MCP（模型上下文协议）服务器，使Claude Desktop能够与您的OmniFocus任务、项目和工作流进行交互。让克劳德自然地管理你的任务： _“为明天创建任务”_, _“显示过期项目”_，或 _“以最佳方式安排我剩余的工作”_.
主要特点
✅ 完成任务管理 -创建、更新、删除任务和项目\ ✅ 自然语言日期 -“明天下午2点”、“下周五”、“三天后”\ ✅ 批量操作 -高效地处理多个任务\ ✅ 智能调度 -优化任务分配和工作负载平衡\ ✅ 标签和项目组织 -完整的层次结构支持\ ✅ 内置视角 -访问收件箱、预测、标记等
需求
- macOS 10.15+
- GTD 软件 （任何版本）
- Node.js 18+
- 克劳德桌面
安装
自动安装（推荐）
# 1. Clone and install
git clone https://github.com/drcdev/focus-pocus.git
cd focus-pocus
# 2. Run the installation script
./install.sh脚本将：
- ✅ 检查所有先决条件
- ✅ 安装依赖项并构建项目
- ✅ 设置macOS自动化权限
- ✅ 自动配置克劳德桌面
- ✅ 测试整个安装
手动安装
如果您更喜欢手动设置：
# 1. Install and build
git clone https://github.com/drcdev/focus-pocus.git
cd focus-pocus
npm install && npm run build
# 2. Configure Claude Desktop
# Edit: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"focus-pocus": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/focus-pocus/dist/index.js"],
"env": {}
}
}
}
# 3. Grant automation permissions when prompted
# 4. Restart Claude Desktop备注：替换drcdev与实际的存储库所有者和/ABSOLUTE/PATH/TO/focus-pocus使用您的安装路径。
快速开始
安装后：
- 启动OmniFocus 和 克劳德桌面
- 测试连接 问克劳德：
Can you show me my current tasks in OmniFocus?- 尝试以下示例命令:
# Basic operations
Create a task "Review project proposal" due tomorrow
Show me all tasks in my "Work" project
Mark the task "Buy groceries" as complete
# Natural language dates
Create a task "Team meeting" for next Monday at 10am
Schedule "Finish report" for Friday afternoon
# Advanced features
Show me my overdue tasks
Schedule my remaining tasks optimally this week
What's in my Forecast for today?故障排除
连接问题？ 问克劳德： Can you diagnose my OmniFocus connection?
需要帮助？ 查看中的详细故障排除指南 docs/local-deployment.md
可用操作
Focus Pocus支持35种以上的操作，涵盖OmniFocus管理的各个方面：
任务和项目
- 任务管理：创建、更新、完成、删除、移动任务
- 项目运营：创建项目、管理状态、组织文件夹
- 批量操作：高效地创建/更新/删除多个项目
- 搜索和筛选：按内容、标签、日期、完成状态查找任务
组织与规划
- 标签管理：使用层次结构支持创建、分配、删除标签
- 日期处理：自然语言解析（“明天”、“下周五下午2点”）
- 透视访问：查看收件箱、预测、标记、项目等
- 智能调度：具有工作负载平衡的最佳任务分配
高级功能
- 渐进式截止日期：项目智能截止日期生成
- 批处理：以原子方式处理多个操作
- 连接诊断：全面的系统健康检查
- 性能优化：大型数据库的缓存和分页
技术细节
建筑
- TypeScript MCP服务器 -3800+行代码
- JXA集成 -39个用于自动化脚本的JavaScript
- 缓存层 -高性能，智能失效
- 35+MCP工具 -全面覆盖OmniFocus API
发展
# Essential commands
npm run build # Build for production
npm run typecheck # Type checking
npm test # Run test suite
node dist/index.js # Run MCP server manually有关详细的开发设置，请参阅 docs/local-deployment.md
故障排除
快速修复
“找不到命令：节点”\ → 从以下位置安装Node.js 18+ 或 brew install node
“未授权”或“自动化错误”\ → 授予自动化权限： 系统首选项 → 安全与隐私 → 隐私 → 自动化 → 为OmniFocus启用终端应用程序
“找不到模块”错误\ → Run npm install && npm run build
“找不到MCP服务器”\ → 检查Claude Desktop配置中的绝对路径： cd focus-pocus && pwd
连接超时\ → 大型数据库在首次运行时速度较慢，后续请求使用缓存
详细帮助
有关包括分步解决方案、权限设置和高级调试在内的全面故障排除，请参阅 docs/local-deployment.md
还有问题吗？ 问克劳德： Can you diagnose my OmniFocus connection?
配置
Focus Pocus开箱即用。对于高级用户，请通过Claude Desktop配置中的环境变量进行自定义：
{
"mcpServers": {
"focus-pocus": {
"command": "node",
"args": ["/path/to/focus-pocus/dist/index.js"],
"env": {
"LOG_LEVEL": "info",
"JXA_TIMEOUT": "45000",
"CACHE_MAX_SIZE": "500",
"DEFAULT_LIMIT": "25"
}
}
}
}性能提示：
- 大型数据库（1000+个任务）：增加
JXA_TIMEOUT向60000 - 有限存储器：减少
CACHE_MAX_SIZE向100 - 调试：设置
LOG_LEVEL向debug
状态和路线图
当前状态：✅ 特性完成
Focus Pocus已完成第1-3阶段的开发，包括：
- ✅ 35+MCP工具 -完整的OmniFocus工作流程覆盖
- ✅ 39个JXA脚本 -具有错误处理功能的全面自动化
- ✅ 高级功能 -自然语言日期、智能调度、批量操作
- ✅ 性能优化 -缓存、分页、优雅的错误恢复
即将推出的功能：
- 🚀 项目模板 -智能工程脚手架
- 📊 基础分析 -任务完成见解和报告
- 🔧 增强的性能 -进一步优化大型数据库
贡献与支持
贡献：分叉，创建一个功能分支，并提交一个pull请求
支持:
- 对于bug
- 回答问题
- 本地部署指南 获取详细帮助
______________________________________________________________________
内置于❤️ 面向OmniFocus和人工智能社区• 许可证：ISC