omnifocus-mcp-enhanced 1.6.11 → 1.8.0

package/README.md

@@ -44,6 +44,8 @@ Want to see where the project is heading next? See the [roadmap](docs/roadmap/20
 
 ## 🆕 Latest Release
 
+- **v1.8.0** - Added full **Folder Management** support: `add_folder`, `edit_folder`, `remove_folder`, `list_folders`, and `get_folder`. Create nested folder hierarchies, rename/move folders (with cycle protection), and inspect folder contents (child projects + subfolders). Note: removing a folder permanently deletes all projects and tasks it contains.
+- **v1.7.0** - Added OmniFocus 4.7+ repeat rule support via `set_repetition_rule` (ICS rule strings, schedule type, anchor date, catch-up, end date, repetition count), mutually exclusive tag support via `exclusiveTags` on add/edit tools, and improved planned-date editing tests.
 - **v1.6.10** - Fixed Inbox task completion via `edit_item`, fixed AppleScript special-character handling for apostrophes/backslashes, fixed JSON result escaping for special characters, and clarified `batch_add_items` / `mcporter` usage with working examples.
 - **v1.6.9** - Added task attachment support: `get_task_by_id` now lists attachment metadata, `dump_database` exports attachment/link metadata, and new `read_task_attachment` returns image attachments as MCP image content when possible.
 - **v1.6.8** - Added stable task move support via `move_task` and `edit_item` (`newProjectId/newProjectName/newParentTaskId/newParentTaskName/moveToInbox`) with duplicate-name protection and cycle-prevention checks.
@@ -64,8 +66,11 @@ Want to see where the project is heading next? See the [roadmap](docs/roadmap/20
 - **🎯 Batch Operations** - Add/remove multiple tasks efficiently
 - **📊 Smart Querying** - Find tasks by ID, name, or complex criteria
 - **🔄 Full CRUD Operations** - Create, read, update, delete tasks and projects
+- **📁 Folder Management** - Full CRUD for folders with nested hierarchy, move/rename, and content inspection
 - **📅 Time Management** - Due, defer, planned dates, estimates, and scheduling
 - **🏷️ Advanced Tagging** - Tag-based filtering with exact/partial matching
+- **🚫 Mutually Exclusive Tags** - Automatically respects exclusive tag groups when applying tags
+- **🔁 Repeat Rules** - Full OmniFocus 4.7+ repetition support (ICS rules, schedule type, anchor date, catch-up, end date, count)
 - **🤖 AI Integration** - Seamless Claude AI integration for intelligent workflows
 - **🖼️ Attachment-Aware Reads** - Surface note attachments and linked files before deciding whether AI should inspect them
 
@@ -509,8 +514,15 @@ read_task_attachment {
 16. **list_custom_perspectives** - 🌟 **NEW**: List all custom perspectives with details
 17. **get_custom_perspective_tasks** - 🌟 **NEW**: Access custom perspective with hierarchical display
 
+### 📁 Folder Management Tools (NEW)
+18. **add_folder** - 🆕 **NEW**: Create a folder, optionally nested under a parent folder
+19. **edit_folder** - 🆕 **NEW**: Rename a folder or move it under a different parent (empty string moves to root)
+20. **remove_folder** - 🆕 **NEW**: Delete a folder (⚠️ also deletes all contained projects and tasks)
+21. **list_folders** - 🆕 **NEW**: List all folders with IDs, parents, status, and project counts
+22. **get_folder** - 🆕 **NEW**: Get a single folder with its child projects and subfolders
+
 ### 📊 Analytics & Tracking
-18. **get_today_completed_tasks** - View today's completed tasks
+23. **get_today_completed_tasks** - View today's completed tasks
 
 Batch move feature roadmap (future): [docs/roadmap/2026-02-25-batch-move-tasks-plan.md](docs/roadmap/2026-02-25-batch-move-tasks-plan.md)
 
@@ -620,6 +632,29 @@ get_custom_perspective_tasks {
 }
 ```
 
+### 📁 Folder Management
+
+```bash
+# List all folders with project counts
+list_folders {"includeDropped": false}
+
+# Create a top-level folder
+add_folder {"name": "Work"}
+
+# Create a nested folder
+add_folder {"name": "Clients", "parentFolderName": "Work"}
+
+# Inspect a folder's projects and subfolders
+get_folder {"name": "Work"}
+
+# Rename or move a folder (empty string moves to root)
+edit_folder {"name": "Clients", "newName": "Key Clients"}
+edit_folder {"name": "Key Clients", "newParentFolderName": ""}
+
+# Delete a folder (⚠️ also deletes all contained projects and tasks)
+remove_folder {"name": "Old Archive"}
+```
+
 ## 🔧 Configuration
 
 ### Claude Code

package/README.zh.md

@@ -40,6 +40,7 @@ OmniFocus 本身已经很强了，但它大多数时候仍然是一个需要你
 
 ## 🆕 最新版本
 
+- **v1.7.0** - 新增 OmniFocus 4.7+ 重复规则支持（`set_repetition_rule`：ICS 规则、重复方式、锚定日期、自动追平、结束日期、重复次数），新增互斥标签支持（`exclusiveTags`），并补全计划日期编辑测试。
 - **v1.6.10** - 修复 `edit_item` 无法完成 Inbox 任务的问题，修复 AppleScript 对单引号/反斜杠等特殊字符的处理，修复特殊字符导致的 JSON 返回解析失败，并补充 `batch_add_items` / `mcporter` 的可直接运行示例与说明。
 - **v1.6.9** - 新增任务附件支持：`get_task_by_id` 会返回附件元信息，`dump_database` 导出附件/链接元信息，并新增 `read_task_attachment`，可在支持时直接把图片附件作为 MCP 图片内容返回。
 - **v1.6.6** - 新增 Planned Date（计划日期）全链路支持：创建/编辑/读取/过滤/排序/导出，包含 `plannedDate` / `newPlannedDate`。
@@ -61,6 +62,8 @@ OmniFocus 本身已经很强了，但它大多数时候仍然是一个需要你
 - **🔄 完整 CRUD 操作** - 创建、读取、更新、删除任务和项目
 - **📅 时间管理** - 截止日期、推迟日期、计划日期、估时和计划
 - **🏷️ 高级标签** - 基于标签的精确/模糊匹配过滤
+- **🚫 互斥标签** - 应用标签时自动遵守互斥标签组规则
+- **🔁 重复规则** - 完整支持 OmniFocus 4.7+ 重复任务（ICS 规则、重复方式、锚定日期、自动追平、结束日期、重复次数）
 - **🤖 AI 集成** - 与 Claude AI 无缝集成，实现智能工作流
 - **🖼️ 附件感知读取** - 先暴露备注附件和链接文件的元信息，再决定是否让 AI 继续查看附件内容
 

package/dist/omnifocustypes.js

@@ -18,6 +18,17 @@ export var Task;
         RepetitionMethod[RepetitionMethod["Fixed"] = 2] = "Fixed";
         RepetitionMethod[RepetitionMethod["None"] = 3] = "None";
     })(RepetitionMethod = Task.RepetitionMethod || (Task.RepetitionMethod = {}));
+    let RepetitionScheduleType;
+    (function (RepetitionScheduleType) {
+        RepetitionScheduleType[RepetitionScheduleType["Regularly"] = 0] = "Regularly";
+        RepetitionScheduleType[RepetitionScheduleType["FromCompletion"] = 1] = "FromCompletion";
+    })(RepetitionScheduleType = Task.RepetitionScheduleType || (Task.RepetitionScheduleType = {}));
+    let AnchorDateKey;
+    (function (AnchorDateKey) {
+        AnchorDateKey[AnchorDateKey["DeferDate"] = 0] = "DeferDate";
+        AnchorDateKey[AnchorDateKey["DueDate"] = 1] = "DueDate";
+        AnchorDateKey[AnchorDateKey["PlannedDate"] = 2] = "PlannedDate";
+    })(AnchorDateKey = Task.AnchorDateKey || (Task.AnchorDateKey = {}));
 })(Task || (Task = {}));
 export var Project;
 (function (Project) {

package/dist/server.js

@@ -13,6 +13,7 @@ import * as batchRemoveItemsTool from './tools/definitions/batchRemoveItems.js';
 import * as getTaskByIdTool from './tools/definitions/getTaskById.js';
 import * as readTaskAttachmentTool from './tools/definitions/readTaskAttachment.js';
 import * as getTodayCompletedTasksTool from './tools/definitions/getTodayCompletedTasks.js';
+import * as setRepetitionRuleTool from './tools/definitions/setRepetitionRule.js';
 // Import perspective tools
 import * as getInboxTasksTool from './tools/definitions/getInboxTasks.js';
 import * as getFlaggedTasksTool from './tools/definitions/getFlaggedTasks.js';
@@ -24,10 +25,16 @@ import * as filterTasksTool from './tools/definitions/filterTasks.js';
 // Import custom perspective tools
 import * as listCustomPerspectivesTool from './tools/definitions/listCustomPerspectives.js';
 import * as getCustomPerspectiveTasksTool from './tools/definitions/getCustomPerspectiveTasks.js';
+// Import folder management tools
+import * as addFolderTool from './tools/definitions/addFolder.js';
+import * as editFolderTool from './tools/definitions/editFolder.js';
+import * as removeFolderTool from './tools/definitions/removeFolder.js';
+import * as listFoldersTool from './tools/definitions/listFolders.js';
+import * as getFolderTool from './tools/definitions/getFolder.js';
 // Create an MCP server
 const server = new McpServer({
     name: "OmniFocus MCP",
-    version: "1.6.9"
+    version: "1.8.0"
 });
 // Register tools
 server.tool("dump_database", "Gets the current state of your OmniFocus database", dumpDatabaseTool.schema.shape, dumpDatabaseTool.handler);
@@ -41,6 +48,7 @@ server.tool("batch_remove_items", "Remove multiple tasks or projects from OmniFo
 server.tool("get_task_by_id", "Get information about a specific task by ID or name", getTaskByIdTool.schema.shape, getTaskByIdTool.handler);
 server.tool("read_task_attachment", "Read a task attachment reported by get_task_by_id. Images are returned as MCP image content when possible.", readTaskAttachmentTool.schema.shape, readTaskAttachmentTool.handler);
 server.tool("get_today_completed_tasks", "Get tasks completed today - view today's accomplishments", getTodayCompletedTasksTool.schema.shape, getTodayCompletedTasksTool.handler);
+server.tool("set_repetition_rule", "Set, update, or clear the repeat rule on a task. Supports ICS rule strings, schedule type, anchor date, catch-up, end date, and repetition count.", setRepetitionRuleTool.schema.shape, setRepetitionRuleTool.handler);
 // Register perspective tools
 server.tool("get_inbox_tasks", "Get tasks from OmniFocus inbox perspective", getInboxTasksTool.schema.shape, getInboxTasksTool.handler);
 server.tool("get_flagged_tasks", "Get flagged tasks from OmniFocus with optional project filtering", getFlaggedTasksTool.schema.shape, getFlaggedTasksTool.handler);
@@ -52,6 +60,12 @@ server.tool("filter_tasks", "Advanced task filtering with unlimited perspective
 // Custom perspective tools
 server.tool("list_custom_perspectives", "List all custom perspectives defined in OmniFocus", listCustomPerspectivesTool.schema.shape, listCustomPerspectivesTool.handler);
 server.tool("get_custom_perspective_tasks", "Get tasks from a specific OmniFocus custom perspective by name. Use this when user refers to perspective names like '今日工作安排', '今日复盘', '本周项目' etc. - these are custom views created in OmniFocus, NOT tags. Supports hierarchical tree display of task relationships.", getCustomPerspectiveTasksTool.schema.shape, getCustomPerspectiveTasksTool.handler);
+// Folder management tools
+server.tool("add_folder", "Create a new folder in OmniFocus, optionally nested under a parent folder. Folders organize projects into a hierarchy.", addFolderTool.schema.shape, addFolderTool.handler);
+server.tool("edit_folder", "Rename a folder or move it under a different parent folder (use an empty string for newParentFolderName to move it to the root level).", editFolderTool.schema.shape, editFolderTool.handler);
+server.tool("remove_folder", "Remove a folder from OmniFocus. WARNING: this also permanently deletes all projects and tasks contained in the folder.", removeFolderTool.schema.shape, removeFolderTool.handler);
+server.tool("list_folders", "List all OmniFocus folders with IDs, parent relationships, status, and project counts without loading tasks.", listFoldersTool.schema.shape, listFoldersTool.handler);
+server.tool("get_folder", "Get a single OmniFocus folder by ID or name, including its child projects and subfolders.", getFolderTool.schema.shape, getFolderTool.handler);
 // Start the MCP server
 const transport = new StdioServerTransport();
 // Use await with server.connect to ensure proper connection

package/dist/tools/definitions/addFolder.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { addFolder } from '../primitives/addFolder.js';
+export const schema = z.object({
+    name: z.string().describe('The name of the folder'),
+    parentFolderName: z.string().optional().describe('The name of the parent folder to nest this folder under (created at the root level if not specified)')
+});
+export async function handler(args, _extra) {
+    try {
+        const result = await addFolder(args);
+        if (result.success) {
+            const locationText = args.parentFolderName
+                ? `inside folder "${args.parentFolderName}"`
+                : 'at the root level';
+            return {
+                content: [{
+                        type: 'text',
+                        text: `✅ Folder "${args.name}" created successfully ${locationText}.\n\nid: ${result.folderId}`
+                    }]
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to create folder: ${result.error}`
+                }],
+            isError: true
+        };
+    }
+    catch (err) {
+        const error = err;
+        console.error(`Tool execution error: ${error.message}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error creating folder: ${error.message}`
+                }],
+            isError: true
+        };
+    }
+}

package/dist/tools/definitions/addOmniFocusTask.js

@@ -9,6 +9,7 @@ export const schema = z.object({
     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"),
+    exclusiveTags: z.boolean().optional().describe("Respect mutually exclusive tag groups when applying tags (default: true). When a tag belongs to an exclusive group, sibling tags from that group are removed."),
     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)")
@@ -39,10 +40,13 @@ export async function handler(args, extra) {
             let plannedDateText = args.plannedDate
                 ? ` planned for ${new Date(args.plannedDate).toLocaleDateString()}`
                 : "";
+            let exclusivityText = result.removedSiblings && result.removedSiblings.length > 0
+                ? `\nRemoved mutually exclusive tags: ${result.removedSiblings.join(', ')}`
+                : "";
             return {
                 content: [{
                         type: "text",
-                        text: `✅ Task "${args.name}" created successfully ${locationText}${dueDateText}${plannedDateText}${tagText}.\n\nid: ${result.taskId}`
+                        text: `✅ Task "${args.name}" created successfully ${locationText}${dueDateText}${plannedDateText}${tagText}.\n\nid: ${result.taskId}${exclusivityText}`
                     }]
             };
         }

package/dist/tools/definitions/addProject.js

@@ -9,6 +9,7 @@ export const schema = z.object({
     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"),
+    exclusiveTags: z.boolean().optional().describe("Respect mutually exclusive tag groups when applying tags (default: true). When a tag belongs to an exclusive group, sibling tags from that group are removed."),
     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)")
 });
@@ -33,10 +34,13 @@ export async function handler(args, extra) {
             let sequentialText = args.sequential
                 ? " (sequential)"
                 : " (parallel)";
+            let exclusivityText = result.removedSiblings && result.removedSiblings.length > 0
+                ? `\nRemoved mutually exclusive tags: ${result.removedSiblings.join(', ')}`
+                : "";
             return {
                 content: [{
                         type: "text",
-                        text: `✅ Project "${args.name}" created successfully ${locationText}${dueDateText}${plannedDateText}${tagText}${sequentialText}.\n\nid: ${result.projectId}`
+                        text: `✅ Project "${args.name}" created successfully ${locationText}${dueDateText}${plannedDateText}${tagText}${sequentialText}.\n\nid: ${result.projectId}${exclusivityText}`
                     }]
             };
         }

package/dist/tools/definitions/editFolder.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { editFolder } from '../primitives/editFolder.js';
+export const schema = z.object({
+    id: z.string().optional().describe('The ID of the folder to edit'),
+    name: z.string().optional().describe('The name of the folder to edit (as fallback if ID not provided)'),
+    newName: z.string().optional().describe('New name for the folder'),
+    newParentFolderName: z.string().optional().describe('Move the folder under this parent folder. Use an empty string "" to move it to the root level.')
+});
+export async function handler(args, _extra) {
+    try {
+        if (!args.id && !args.name) {
+            return {
+                content: [{ type: 'text', text: 'Either id or name must be provided to edit a folder.' }],
+                isError: true
+            };
+        }
+        const result = await editFolder(args);
+        if (result.success) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `✅ Folder "${result.name}" updated successfully.\nChanged: ${result.changedProperties || 'nothing'}\n\nid: ${result.id}`
+                    }]
+            };
+        }
+        return {
+            content: [{ type: 'text', text: `Failed to edit folder: ${result.error}` }],
+            isError: true
+        };
+    }
+    catch (err) {
+        const error = err;
+        console.error(`Tool execution error: ${error.message}`);
+        return {
+            content: [{ type: 'text', text: `Error editing folder: ${error.message}` }],
+            isError: true
+        };
+    }
+}

package/dist/tools/definitions/editItem.js

@@ -17,6 +17,7 @@ export const schema = z.object({
     addTags: z.array(z.string()).optional().describe("Tags to add to the task"),
     removeTags: z.array(z.string()).optional().describe("Tags to remove from the task"),
     replaceTags: z.array(z.string()).optional().describe("Tags to replace all existing tags with"),
+    exclusiveTags: z.boolean().optional().describe("Respect mutually exclusive tag groups when adding/replacing tags (default: true). When a tag belongs to an exclusive group, sibling tags from that group are removed."),
     newProjectId: z.string().optional().describe("For tasks: move task to this project ID"),
     newProjectName: z.string().optional().describe("For tasks: move task to this project name (errors on duplicate names)"),
     newParentTaskId: z.string().optional().describe("For tasks: move task under this parent task ID"),
@@ -48,10 +49,13 @@ export async function handler(args, extra) {
             if (result.changedProperties) {
                 changedText = ` (${result.changedProperties})`;
             }
+            let exclusivityText = result.removedSiblings && result.removedSiblings.length > 0
+                ? `\nRemoved mutually exclusive tags: ${result.removedSiblings.join(', ')}`
+                : "";
             return {
                 content: [{
                         type: "text",
-                        text: `✅ ${itemTypeLabel} "${result.name}" updated successfully${changedText}.`
+                        text: `✅ ${itemTypeLabel} "${result.name}" updated successfully${changedText}.${exclusivityText}`
                     }]
             };
         }

package/dist/tools/definitions/getFolder.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { getFolder } from '../primitives/getFolder.js';
+export const schema = z.object({
+    id: z.string().optional().describe('The ID of the folder to get'),
+    name: z.string().optional().describe('The name of the folder to get (as fallback if ID not provided)')
+});
+export async function handler(args, _extra) {
+    try {
+        if (!args.id && !args.name) {
+            return {
+                content: [{ type: 'text', text: 'Either id or name must be provided to get a folder.' }],
+                isError: true
+            };
+        }
+        const folder = await getFolder({ id: args.id, name: args.name });
+        const lines = [];
+        lines.push(`# Folder: ${folder.name}`);
+        lines.push('');
+        lines.push(`- id: ${folder.id}`);
+        lines.push(`- status: ${folder.status}`);
+        if (folder.parentFolderID) {
+            lines.push(`- parent folder id: ${folder.parentFolderID}`);
+        }
+        lines.push('');
+        lines.push(`## Subfolders (${folder.subfolders.length})`);
+        if (folder.subfolders.length === 0) {
+            lines.push('None');
+        }
+        else {
+            for (const sub of folder.subfolders) {
+                lines.push(`- ${sub.name} [${sub.status}] (id:${sub.id})`);
+            }
+        }
+        lines.push('');
+        lines.push(`## Projects (${folder.projects.length})`);
+        if (folder.projects.length === 0) {
+            lines.push('None');
+        }
+        else {
+            for (const project of folder.projects) {
+                lines.push(`- ${project.name} [${project.status}] (id:${project.id}, remaining:${project.remainingTaskCount})`);
+            }
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        return {
+            content: [{ type: 'text', text: `Error getting folder: ${message}` }],
+            isError: true
+        };
+    }
+}

package/dist/tools/definitions/listFolders.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { listFolders } from '../primitives/listFolders.js';
+export const schema = z.object({
+    includeDropped: z.boolean().optional().describe('Include dropped folders (default: true)')
+});
+export async function handler(args, _extra) {
+    try {
+        const result = await listFolders(args.includeDropped !== false);
+        return { content: [{ type: 'text', text: result }] };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        return {
+            content: [{ type: 'text', text: `Error listing folders: ${message}` }],
+            isError: true
+        };
+    }
+}

package/dist/tools/definitions/plannedDateSchemas.test.js

@@ -74,3 +74,28 @@ test('filter_tasks schema supports planned date filters and sorting', () => {
     assert.equal(parsed.plannedBefore, '2026-02-20');
     assert.equal(parsed.sortBy, 'plannedDate');
 });
+test('add_omnifocus_task schema preserves exclusiveTags', () => {
+    const parsed = addTaskSchema.parse({
+        name: 'Task with exclusive tags',
+        tags: ['High', 'Work'],
+        exclusiveTags: false
+    });
+    assert.equal(parsed.exclusiveTags, false);
+});
+test('add_project schema preserves exclusiveTags', () => {
+    const parsed = addProjectSchema.parse({
+        name: 'Project with exclusive tags',
+        tags: ['High'],
+        exclusiveTags: true
+    });
+    assert.equal(parsed.exclusiveTags, true);
+});
+test('edit_item schema preserves exclusiveTags', () => {
+    const parsed = editItemSchema.parse({
+        itemType: 'task',
+        id: 'abc',
+        addTags: ['High'],
+        exclusiveTags: true
+    });
+    assert.equal(parsed.exclusiveTags, true);
+});

package/dist/tools/definitions/removeFolder.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { removeFolder } from '../primitives/removeFolder.js';
+export const schema = z.object({
+    id: z.string().optional().describe('The ID of the folder to remove'),
+    name: z.string().optional().describe('The name of the folder to remove (as fallback if ID not provided)')
+});
+export async function handler(args, _extra) {
+    try {
+        if (!args.id && !args.name) {
+            return {
+                content: [{ type: 'text', text: 'Either id or name must be provided to remove a folder.' }],
+                isError: true
+            };
+        }
+        const result = await removeFolder(args);
+        if (result.success) {
+            const projectCount = result.deletedProjectCount ?? 0;
+            const taskCount = result.deletedTaskCount ?? 0;
+            const cascadeWarning = (projectCount > 0 || taskCount > 0)
+                ? `\n⚠️ This also permanently deleted ${projectCount} contained project(s) and ${taskCount} task(s).`
+                : '';
+            return {
+                content: [{
+                        type: 'text',
+                        text: `✅ Folder "${result.name}" removed successfully.${cascadeWarning}`
+                    }]
+            };
+        }
+        let errorMsg = 'Failed to remove folder';
+        if (result.error) {
+            if (result.error.includes('Folder not found')) {
+                errorMsg = 'Folder not found';
+                if (args.id)
+                    errorMsg += ` with ID "${args.id}"`;
+                if (args.name)
+                    errorMsg += `${args.id ? ' or' : ' with'} name "${args.name}"`;
+                errorMsg += '.';
+            }
+            else {
+                errorMsg += `: ${result.error}`;
+            }
+        }
+        return {
+            content: [{ type: 'text', text: errorMsg }],
+            isError: true
+        };
+    }
+    catch (err) {
+        const error = err;
+        console.error(`Tool execution error: ${error.message}`);
+        return {
+            content: [{ type: 'text', text: `Error removing folder: ${error.message}` }],
+            isError: true
+        };
+    }
+}

package/dist/tools/definitions/setRepetitionRule.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { setRepetitionRule } from '../primitives/setRepetitionRule.js';
+export const schema = z.object({
+    taskId: z.string().describe('The ID of the task to modify'),
+    ruleString: z
+        .string()
+        .optional()
+        .describe('ICS recurrence rule string, e.g. FREQ=WEEKLY;INTERVAL=2. Defaults to FREQ=WEEKLY.'),
+    scheduleType: z
+        .enum(['Regularly', 'FromCompletion'])
+        .optional()
+        .describe('How the next occurrence is scheduled. Regularly repeats from assigned dates; FromCompletion repeats after completion.'),
+    anchorDateKey: z
+        .enum(['DueDate', 'DeferDate', 'PlannedDate'])
+        .optional()
+        .describe('Which date property is advanced when the task repeats.'),
+    catchUpAutomatically: z
+        .boolean()
+        .optional()
+        .describe('When true, missed occurrences are skipped and the next future occurrence is created.'),
+    endDate: z
+        .string()
+        .optional()
+        .describe('ISO date string for when the repetition ends. Encoded into the rule as UNTIL=.'),
+    count: z
+        .number()
+        .optional()
+        .describe('Number of repetitions after which the rule ends. Encoded into the rule as COUNT=.'),
+    clear: z
+        .boolean()
+        .optional()
+        .describe('Set to true to remove the repetition rule from the task.'),
+});
+export async function handler(args, extra) {
+    try {
+        const result = await setRepetitionRule({
+            taskId: args.taskId,
+            ruleString: args.ruleString,
+            scheduleType: args.scheduleType,
+            anchorDateKey: args.anchorDateKey,
+            catchUpAutomatically: args.catchUpAutomatically,
+            endDate: args.endDate,
+            count: args.count,
+            clear: args.clear,
+        });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to set repetition rule: ${result.error || 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (result.cleared) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Repetition rule cleared successfully.',
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Repetition rule set successfully.\nRule: ${result.ruleString}\nSchedule: ${result.scheduleType}\nAnchor: ${result.anchorDateKey}\nCatch up automatically: ${result.catchUpAutomatically}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error setting repetition rule: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/definitions/setRepetitionRule.test.js

@@ -0,0 +1,42 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { schema } from './setRepetitionRule.js';
+test('set_repetition_rule schema requires taskId', () => {
+    assert.throws(() => schema.parse({}));
+});
+test('set_repetition_rule schema accepts minimal valid input', () => {
+    const parsed = schema.parse({ taskId: 'abc123' });
+    assert.equal(parsed.taskId, 'abc123');
+});
+test('set_repetition_rule schema accepts full repetition config', () => {
+    const parsed = schema.parse({
+        taskId: 'abc123',
+        ruleString: 'FREQ=WEEKLY;INTERVAL=2',
+        scheduleType: 'FromCompletion',
+        anchorDateKey: 'PlannedDate',
+        catchUpAutomatically: true,
+        endDate: '2026-12-31T23:59:59.000Z',
+        count: 10,
+    });
+    assert.equal(parsed.ruleString, 'FREQ=WEEKLY;INTERVAL=2');
+    assert.equal(parsed.scheduleType, 'FromCompletion');
+    assert.equal(parsed.anchorDateKey, 'PlannedDate');
+    assert.equal(parsed.catchUpAutomatically, true);
+    assert.equal(parsed.count, 10);
+});
+test('set_repetition_rule schema rejects invalid scheduleType', () => {
+    assert.throws(() => schema.parse({
+        taskId: 'abc123',
+        scheduleType: 'Sometimes',
+    }));
+});
+test('set_repetition_rule schema rejects invalid anchorDateKey', () => {
+    assert.throws(() => schema.parse({
+        taskId: 'abc123',
+        anchorDateKey: 'StartDate',
+    }));
+});
+test('set_repetition_rule schema accepts clear flag', () => {
+    const parsed = schema.parse({ taskId: 'abc123', clear: true });
+    assert.equal(parsed.clear, true);
+});