omnifocus-mcp-enhanced 1.1.0

package/.claude/settings.local.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:discourse.omnigroup.com)",
+      "Bash(npm run build:*)",
+      "Bash(npx tsc:*)",
+      "Bash(npm install)",
+      "Bash(node:*)",
+      "Bash(osascript:*)",
+      "Bash(claude mcp:*)",
+      "Bash(chmod:*)",
+      "Bash(npm pack:*)",
+      "Bash(./publish.sh:*)"
+    ],
+    "deny": []
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,280 @@
+# OmniFocus MCP Enhanced - Claude Code 使用指南
+
+这是一个增强版的 OmniFocus MCP 服务器，新增了完整的子任务功能支持。
+
+## 🚀 新功能特性
+
+### ✨ 子任务功能
+- **通过父任务ID创建子任务**
+- **通过父任务名称创建子任务**
+- **专门的子任务创建工具**
+- **批量子任务创建支持**
+- **完整的任务层级管理**
+
+### 🛠 新增工具
+1. **`add_subtask`** - 专门的子任务创建工具
+2. **`get_task_by_id`** - 任务信息查询工具
+3. **增强的 `add_omnifocus_task`** - 支持父任务参数
+4. **增强的 `batch_add_items`** - 支持批量创建子任务
+
+## 📦 安装方式
+
+### 方式1：NPM 发布版本安装（推荐）
+
+如果已发布到 NPM：
+
+```bash
+# 1. 移除原有的 OmniFocus MCP（如果有）
+claude mcp remove omnifocus
+
+# 2. 一键安装增强版
+claude mcp add omnifocus-enhanced -- npx -y omnifocus-mcp-enhanced
+
+# 3. 验证安装
+claude mcp list
+```
+
+**或者全局安装：**
+```bash
+npm install -g omnifocus-mcp-enhanced
+claude mcp add omnifocus-enhanced -- omnifocus-mcp-enhanced
+```
+
+### 方式2：本地项目安装
+
+如果你有项目源码：
+
+```bash
+# 1. 移除原有的 OmniFocus MCP（如果有）
+claude mcp remove omnifocus
+
+# 2. 进入项目目录并构建
+cd "/path/to/OmniFocus-MCP"
+npm install
+npm run build
+
+# 3. 添加增强版 MCP
+claude mcp add omnifocus-enhanced -- node "/path/to/OmniFocus-MCP/dist/server.js"
+
+# 4. 验证安装
+claude mcp list
+```
+
+**实际安装命令示例：**
+```bash
+claude mcp add omnifocus-enhanced -- node "/Users/zhangte/Library/Mobile Documents/iCloud~md~obsidian/Documents/obsidian-zhangte/1-当前项目/claude code-研究/MCPS/omnifocus_mcp/OmniFocus-MCP/dist/server.js"
+```
+
+### 方式3：多设备部署
+
+如果你要在其他 Mac 上使用：
+
+```bash
+# 1. 打包项目（在原Mac上）
+cd "/path/to/OmniFocus-MCP"
+./deploy.sh pack
+
+# 2. 传输到新Mac并解压安装
+# 将生成的 .tar.gz 文件传输到目标Mac
+./deploy.sh install omnifocus-mcp-enhanced-XXXXXXXX-XXXX.tar.gz
+```
+
+### 方式4：使用 CLI 脚本
+
+```bash
+claude mcp add omnifocus-enhanced -- "/path/to/OmniFocus-MCP/cli.cjs"
+```
+
+## 🚀 发布到 NPM
+
+如果你想发布到 NPM 供其他人使用：
+
+### 发布步骤
+
+```bash
+# 1. 检查发布准备状态
+./publish.sh check
+
+# 2. 更新版本（可选）
+./publish.sh version patch  # 或 minor, major
+
+# 3. 发布到 NPM
+./publish.sh release
+```
+
+### 发布前准备
+
+1. **注册 NPM 账号** - https://www.npmjs.com/signup
+2. **登录 NPM**：
+   ```bash
+   npm login
+   ```
+3. **更新个人信息**：
+   - 修改 `package.json` 中的 `author` 信息
+   - 修改 `repository` URL 为你的 GitHub 仓库
+4. **确保包名唯一**：
+   - 检查 NPM 是否已有同名包
+   - 必要时修改 `package.json` 中的 `name`
+
+### 发布后使用
+
+发布成功后，用户可以通过以下命令安装：
+
+```bash
+# 一键安装
+claude mcp add omnifocus-enhanced -- npx -y your-package-name
+
+# 或全局安装
+npm install -g your-package-name
+claude mcp add omnifocus-enhanced -- your-package-name
+```
+
+## 🎯 使用方法
+
+### 1. 创建子任务
+
+#### 方法A：使用增强的 add_omnifocus_task
+```bash
+# 通过父任务ID创建子任务
+add_omnifocus_task {
+  "name": "分析竞争对手关键词",
+  "parentTaskId": "loK2xEAY4H1",
+  "note": "重点分析前10名竞争对手的关键词策略",
+  "dueDate": "2025-01-15",
+  "estimatedMinutes": 120,
+  "tags": ["SEO", "研究"]
+}
+
+# 通过父任务名称创建子任务
+add_omnifocus_task {
+  "name": "制定内容发布计划",
+  "parentTaskName": "内容策略优化",
+  "flagged": true,
+  "estimatedMinutes": 60
+}
+```
+
+#### 方法B：使用专门的 add_subtask 工具
+```bash
+add_subtask {
+  "name": "撰写SEO文章大纲",
+  "parentTaskName": "内容策略优化",
+  "note": "针对目标关键词撰写10篇文章大纲",
+  "dueDate": "2025-01-20",
+  "tags": ["内容", "写作"]
+}
+```
+
+### 2. 批量创建任务和子任务
+
+```bash
+batch_add_items {
+  "items": [
+    {
+      "type": "task",
+      "name": "网站技术优化",
+      "projectName": "谷歌SEO起量",
+      "note": "优化网站技术层面的SEO"
+    },
+    {
+      "type": "task",
+      "name": "页面速度优化",
+      "parentTaskName": "网站技术优化",
+      "estimatedMinutes": 180,
+      "flagged": true
+    },
+    {
+      "type": "task",
+      "name": "移动端适配检查",
+      "parentTaskName": "网站技术优化",
+      "estimatedMinutes": 90
+    },
+    {
+      "type": "task", 
+      "name": "结构化数据添加",
+      "parentTaskName": "网站技术优化",
+      "estimatedMinutes": 120
+    }
+  ]
+}
+```
+
+### 3. 查询任务信息
+
+```bash
+# 通过任务ID查询
+get_task_by_id {
+  "taskId": "loK2xEAY4H1"
+}
+
+# 通过任务名称查询
+get_task_by_id {
+  "taskName": "内容策略优化"
+}
+```
+
+### 4. 查看项目结构
+
+```bash
+# 获取完整的OmniFocus数据库状态
+dump_database {
+  "hideCompleted": false,
+  "hideRecurringDuplicates": true
+}
+```
+
+## ⚠️ 重要提示
+
+### 参数限制
+- **不能同时指定** `parentTaskId` 和 `parentTaskName`
+- **不能同时指定** 父任务参数和 `projectName`（子任务自动继承父任务的项目）
+- **子任务工具必须提供** `parentTaskId` 或 `parentTaskName` 其中之一
+
+### 错误处理
+- 父任务不存在时会返回清晰的错误信息
+- AppleScript 执行失败时会提供详细的错误描述
+- 参数冲突时会在调用前进行验证
+
+## 🔧 开发和调试
+
+### 重新构建
+```bash
+cd "/path/to/OmniFocus-MCP"
+npm run build
+# 重启 Claude Code 以使用最新版本
+```
+
+### 查看日志
+AppleScript 执行日志会输出到 `console.error`，可以通过 Claude Code 的调试模式查看。
+
+### 测试 AppleScript
+```bash
+# 测试查找项目
+osascript -e 'tell application "OmniFocus" to tell front document to name of first flattened project where name contains "SEO"'
+
+# 测试创建任务
+osascript -e 'tell application "OmniFocus" to tell front document to set theProject to first flattened project where name = "谷歌SEO起量" ...'
+```
+
+## 📋 完整工具列表
+
+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. **add_subtask** - 专门创建子任务（新增）
+9. **get_task_by_id** - 查询任务信息（新增）
+
+## 🎉 版本信息
+
+- **基础版本**: 1.0.9
+- **增强版本**: 1.1.0-enhanced
+- **新增功能**: 完整子任务支持
+- **兼容性**: 完全向后兼容原有功能
+
+---
+
+**享受更强大的 OmniFocus 任务管理体验！** 🚀

package/README.md

@@ -0,0 +1,168 @@
+# OmniFocus MCP Enhanced
+
+An enhanced Model Context Protocol (MCP) server for OmniFocus with complete subtask support and advanced task management features.
+
+## 🚀 Features
+
+- **Complete Subtask Support** - Create subtasks by parent task ID or name
+- **Advanced Task Management** - Enhanced task creation with parent-child relationships
+- **Batch Operations** - Bulk create tasks and subtasks efficiently
+- **Task Information Query** - Get detailed task information and hierarchy
+- **Full Backward Compatibility** - All original features preserved
+
+## 📦 Installation
+
+### Quick Install with Claude Code
+
+```bash
+claude mcp add omnifocus-enhanced -- npx -y omnifocus-mcp-enhanced
+```
+
+### Manual Installation
+
+```bash
+npm install -g omnifocus-mcp-enhanced
+claude mcp add omnifocus-enhanced -- omnifocus-mcp-enhanced
+```
+
+## 🎯 New Features
+
+### Subtask Creation
+
+Create subtasks using the enhanced `add_omnifocus_task` tool:
+
+```json
+{
+  "name": "Research competitor keywords",
+  "parentTaskName": "SEO Strategy",
+  "note": "Analyze top 10 competitors",
+  "dueDate": "2025-01-15",
+  "estimatedMinutes": 120,
+  "tags": ["SEO", "Research"]
+}
+```
+
+Or use the dedicated `add_subtask` tool:
+
+```json
+{
+  "name": "Write content outline",
+  "parentTaskId": "task-id-12345",
+  "flagged": true,
+  "estimatedMinutes": 60
+}
+```
+
+### Batch Subtask Creation
+
+Create multiple tasks and subtasks in one operation:
+
+```json
+{
+  "items": [
+    {
+      "type": "task",
+      "name": "Website Optimization",
+      "projectName": "SEO Project"
+    },
+    {
+      "type": "task",
+      "name": "Page Speed Optimization",
+      "parentTaskName": "Website Optimization",
+      "estimatedMinutes": 180
+    },
+    {
+      "type": "task",
+      "name": "Mobile Responsiveness Check",
+      "parentTaskName": "Website Optimization",
+      "estimatedMinutes": 90
+    }
+  ]
+}
+```
+
+### Task Information Query
+
+Get detailed information about any task:
+
+```json
+{
+  "taskId": "task-id-12345"
+}
+```
+
+## 🛠 Available Tools
+
+1. **dump_database** - Get OmniFocus database state
+2. **add_omnifocus_task** - Create tasks (enhanced with subtask support)
+3. **add_project** - Create projects
+4. **remove_item** - Delete tasks or projects
+5. **edit_item** - Edit tasks or projects
+6. **batch_add_items** - Bulk add items (enhanced with subtask support)
+7. **batch_remove_items** - Bulk remove items
+8. **add_subtask** - Dedicated subtask creation (NEW)
+9. **get_task_by_id** - Query task information (NEW)
+
+## 📋 Requirements
+
+- **macOS** - OmniFocus is macOS-only
+- **OmniFocus 3+** - The application must be installed and running
+- **Node.js 18+** - For running the MCP server
+- **Claude Code** - For MCP integration
+
+## 🔧 Usage with Claude Code
+
+After installation, you can use the enhanced features in Claude Code:
+
+```bash
+# Create a subtask
+add_subtask {
+  "name": "Design landing page mockup",
+  "parentTaskName": "Website Redesign",
+  "dueDate": "2025-01-20",
+  "tags": ["Design", "Web"]
+}
+
+# Get task details
+get_task_by_id {
+  "taskName": "Website Redesign"
+}
+
+# Batch create with subtasks
+batch_add_items {
+  "items": [
+    {
+      "type": "task",
+      "name": "Content Strategy",
+      "projectName": "Marketing Campaign"
+    },
+    {
+      "type": "task",
+      "name": "Keyword Research",
+      "parentTaskName": "Content Strategy"
+    }
+  ]
+}
+```
+
+## 📖 Documentation
+
+For detailed usage instructions, see [CLAUDE.md](./CLAUDE.md).
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT License - see LICENSE file for details.
+
+## 🔗 Links
+
+- [OmniFocus](https://www.omnigroup.com/omnifocus/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
+
+## 🙏 Acknowledgments
+
+Based on the original OmniFocus MCP server by [themotionmachine](https://github.com/themotionmachine/omnifocus-mcp-server).

package/cli.cjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// cli.cjs
+const path = require('path');
+const childProcess = require('child_process');
+
+const serverPath = path.join(__dirname, 'dist', 'server.js');
+childProcess.spawn('node', ['--experimental-modules', serverPath], { 
+    stdio: 'inherit'
+});

package/dist/omnifocustypes.js

@@ -0,0 +1,48 @@
+// Core enums
+export var Task;
+(function (Task) {
+    let Status;
+    (function (Status) {
+        Status[Status["Available"] = 0] = "Available";
+        Status[Status["Blocked"] = 1] = "Blocked";
+        Status[Status["Completed"] = 2] = "Completed";
+        Status[Status["Dropped"] = 3] = "Dropped";
+        Status[Status["DueSoon"] = 4] = "DueSoon";
+        Status[Status["Next"] = 5] = "Next";
+        Status[Status["Overdue"] = 6] = "Overdue";
+    })(Status = Task.Status || (Task.Status = {}));
+    let RepetitionMethod;
+    (function (RepetitionMethod) {
+        RepetitionMethod[RepetitionMethod["DeferUntilDate"] = 0] = "DeferUntilDate";
+        RepetitionMethod[RepetitionMethod["DueDate"] = 1] = "DueDate";
+        RepetitionMethod[RepetitionMethod["Fixed"] = 2] = "Fixed";
+        RepetitionMethod[RepetitionMethod["None"] = 3] = "None";
+    })(RepetitionMethod = Task.RepetitionMethod || (Task.RepetitionMethod = {}));
+})(Task || (Task = {}));
+export var Project;
+(function (Project) {
+    let Status;
+    (function (Status) {
+        Status[Status["Active"] = 0] = "Active";
+        Status[Status["Done"] = 1] = "Done";
+        Status[Status["Dropped"] = 2] = "Dropped";
+        Status[Status["OnHold"] = 3] = "OnHold";
+    })(Status = Project.Status || (Project.Status = {}));
+})(Project || (Project = {}));
+export var Folder;
+(function (Folder) {
+    let Status;
+    (function (Status) {
+        Status[Status["Active"] = 0] = "Active";
+        Status[Status["Dropped"] = 1] = "Dropped";
+    })(Status = Folder.Status || (Folder.Status = {}));
+})(Folder || (Folder = {}));
+export var Tag;
+(function (Tag) {
+    let Status;
+    (function (Status) {
+        Status[Status["Active"] = 0] = "Active";
+        Status[Status["Dropped"] = 1] = "Dropped";
+        Status[Status["OnHold"] = 2] = "OnHold";
+    })(Status = Tag.Status || (Tag.Status = {}));
+})(Tag || (Tag = {}));

package/dist/server.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+// Import tool definitions
+import * as dumpDatabaseTool from './tools/definitions/dumpDatabase.js';
+import * as addOmniFocusTaskTool from './tools/definitions/addOmniFocusTask.js';
+import * as addProjectTool from './tools/definitions/addProject.js';
+import * as removeItemTool from './tools/definitions/removeItem.js';
+import * as editItemTool from './tools/definitions/editItem.js';
+import * as batchAddItemsTool from './tools/definitions/batchAddItems.js';
+import * as batchRemoveItemsTool from './tools/definitions/batchRemoveItems.js';
+import * as addSubtaskTool from './tools/definitions/addSubtask.js';
+import * as getTaskByIdTool from './tools/definitions/getTaskById.js';
+// Create an MCP server
+const server = new McpServer({
+    name: "OmniFocus MCP",
+    version: "1.0.0"
+});
+// Register tools
+server.tool("dump_database", "Gets the current state of your OmniFocus database", dumpDatabaseTool.schema.shape, dumpDatabaseTool.handler);
+server.tool("add_omnifocus_task", "Add a new task to OmniFocus", addOmniFocusTaskTool.schema.shape, addOmniFocusTaskTool.handler);
+server.tool("add_project", "Add a new project to OmniFocus", addProjectTool.schema.shape, addProjectTool.handler);
+server.tool("remove_item", "Remove a task or project from OmniFocus", removeItemTool.schema.shape, removeItemTool.handler);
+server.tool("edit_item", "Edit a task or project in OmniFocus", editItemTool.schema.shape, editItemTool.handler);
+server.tool("batch_add_items", "Add multiple tasks or projects to OmniFocus in a single operation", batchAddItemsTool.schema.shape, batchAddItemsTool.handler);
+server.tool("batch_remove_items", "Remove multiple tasks or projects from OmniFocus in a single operation", batchRemoveItemsTool.schema.shape, batchRemoveItemsTool.handler);
+server.tool("add_subtask", "Add a new subtask to an existing task in OmniFocus", addSubtaskTool.schema.shape, addSubtaskTool.handler);
+server.tool("get_task_by_id", "Get information about a specific task by ID or name", getTaskByIdTool.schema.shape, getTaskByIdTool.handler);
+// Start the MCP server
+const transport = new StdioServerTransport();
+// Use await with server.connect to ensure proper connection
+(async function () {
+    try {
+        console.error("Starting MCP server...");
+        await server.connect(transport);
+        console.error("MCP Server connected and ready to accept commands from Claude");
+    }
+    catch (err) {
+        console.error(`Failed to start MCP server: ${err}`);
+    }
+})();
+// For a cleaner shutdown if the process is terminated

package/dist/tools/definitions/addOmniFocusTask.js

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { addOmniFocusTask } from '../primitives/addOmniFocusTask.js';
+export const schema = z.object({
+    name: z.string().describe("The name of the task"),
+    note: z.string().optional().describe("Additional notes for the task"),
+    dueDate: z.string().optional().describe("The due date of the task in ISO format (YYYY-MM-DD or full ISO date)"),
+    deferDate: z.string().optional().describe("The defer date of the task in ISO format (YYYY-MM-DD or full ISO date)"),
+    flagged: z.boolean().optional().describe("Whether the task is flagged or not"),
+    estimatedMinutes: z.number().optional().describe("Estimated time to complete the task, in minutes"),
+    tags: z.array(z.string()).optional().describe("Tags to assign to the task"),
+    projectName: z.string().optional().describe("The name of the project to add the task to (will add to inbox if not specified)"),
+    parentTaskId: z.string().optional().describe("The ID of the parent task to create this task as a subtask"),
+    parentTaskName: z.string().optional().describe("The name of the parent task to create this task as a subtask (alternative to parentTaskId)")
+});
+export async function handler(args, extra) {
+    try {
+        // Call the addOmniFocusTask function 
+        const result = await addOmniFocusTask(args);
+        if (result.success) {
+            // Task was added successfully
+            let locationText;
+            if (args.parentTaskId || args.parentTaskName) {
+                const parentRef = args.parentTaskId || args.parentTaskName;
+                locationText = `as a subtask of "${parentRef}"`;
+            }
+            else if (args.projectName) {
+                locationText = `in project "${args.projectName}"`;
+            }
+            else {
+                locationText = "in your inbox";
+            }
+            let tagText = args.tags && args.tags.length > 0
+                ? ` with tags: ${args.tags.join(', ')}`
+                : "";
+            let dueDateText = args.dueDate
+                ? ` due on ${new Date(args.dueDate).toLocaleDateString()}`
+                : "";
+            return {
+                content: [{
+                        type: "text",
+                        text: `✅ Task "${args.name}" created successfully ${locationText}${dueDateText}${tagText}.`
+                    }]
+            };
+        }
+        else {
+            // Task creation failed
+            return {
+                content: [{
+                        type: "text",
+                        text: `Failed to create task: ${result.error}`
+                    }],
+                isError: true
+            };
+        }
+    }
+    catch (err) {
+        const error = err;
+        console.error(`Tool execution error: ${error.message}`);
+        return {
+            content: [{
+                    type: "text",
+                    text: `Error creating task: ${error.message}`
+                }],
+            isError: true
+        };
+    }
+}

package/dist/tools/definitions/addProject.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { addProject } from '../primitives/addProject.js';
+export const schema = z.object({
+    name: z.string().describe("The name of the project"),
+    note: z.string().optional().describe("Additional notes for the project"),
+    dueDate: z.string().optional().describe("The due date of the project in ISO format (YYYY-MM-DD or full ISO date)"),
+    deferDate: z.string().optional().describe("The defer date of the project in ISO format (YYYY-MM-DD or full ISO date)"),
+    flagged: z.boolean().optional().describe("Whether the project is flagged or not"),
+    estimatedMinutes: z.number().optional().describe("Estimated time to complete the project, in minutes"),
+    tags: z.array(z.string()).optional().describe("Tags to assign to the project"),
+    folderName: z.string().optional().describe("The name of the folder to add the project to (will add to root if not specified)"),
+    sequential: z.boolean().optional().describe("Whether tasks in the project should be sequential (default: false)")
+});
+export async function handler(args, extra) {
+    try {
+        // Call the addProject function 
+        const result = await addProject(args);
+        if (result.success) {
+            // Project was added successfully
+            let locationText = args.folderName
+                ? `in folder "${args.folderName}"`
+                : "at the root level";
+            let tagText = args.tags && args.tags.length > 0
+                ? ` with tags: ${args.tags.join(', ')}`
+                : "";
+            let dueDateText = args.dueDate
+                ? ` due on ${new Date(args.dueDate).toLocaleDateString()}`
+                : "";
+            let sequentialText = args.sequential
+                ? " (sequential)"
+                : " (parallel)";
+            return {
+                content: [{
+                        type: "text",
+                        text: `✅ Project "${args.name}" created successfully ${locationText}${dueDateText}${tagText}${sequentialText}.`
+                    }]
+            };
+        }
+        else {
+            // Project creation failed
+            return {
+                content: [{
+                        type: "text",
+                        text: `Failed to create project: ${result.error}`
+                    }],
+                isError: true
+            };
+        }
+    }
+    catch (err) {
+        const error = err;
+        console.error(`Tool execution error: ${error.message}`);
+        return {
+            content: [{
+                    type: "text",
+                    text: `Error creating project: ${error.message}`
+                }],
+            isError: true
+        };
+    }
+}