@sebastienheyd/clickup-mcp 1.8.0 → 1.9.0

package/README.md

@@ -96,10 +96,10 @@ Turn natural language into powerful ClickUp actions:
 - Create, read, and update documents and pages
 - Add comments and collaborate with team members
 - Manage priorities, due dates, assignees, and tags
-- Handle time estimates and custom field values
+- Handle time estimates, sprint points and custom field values
 
 ### 🔒 **Safety Features**
-- **Append-Only Descriptions**: Description fields are never overwritten - new content is safely appended with timestamps
+- **Append-First Descriptions**: `append_description` adds a dated block under the existing description and is the default for notes. `replace_description` rewrites the whole description on purpose - the previous content is echoed back so a wrong replacement can be undone
 - **Normal Field Updates**: Status, priority, assignees, tags, and dates can be updated normally (easily revertible through ClickUp's history)
 
 ## Installation
@@ -191,14 +191,17 @@ The ClickUp MCP supports three operational modes to balance functionality, secur
 | `getTaskById`          |      ✅       |  ✅   |   ✅   | Get complete task details including comments, images, and metadata                      |
 | `addComment`           |      ❌       |  ❌   |   ✅   | Add comments to tasks for collaboration                                                 |
 | `editComment`          |      ❌       |  ❌   |   ✅   | Correct your own comment within 24h instead of posting a follow-up                      |
-| `updateTask`           |      ❌       |  ❌   |   ✅   | Update tasks (status, priority, assignees, etc.) with **SAFE APPEND-ONLY** descriptions |
+| `deleteComment`        |      ❌       |  ❌   |   ✅   | Delete your own comment within 24h (deleted text is echoed back)                        |
+| `updateTask`           |      ❌       |  ❌   |   ✅   | Update tasks (status, priority, assignees, etc.); append to or replace descriptions     |
 | `createTask`           |      ❌       |  ❌   |   ✅   | Create new tasks with full markdown support                                             |
 | `searchTasks`          |      ✅       |  ✅   |   ✅   | Find tasks by content, keywords, assignees, or project context                          |
 | `searchSpaces`         |      ❌       |  ✅   |   ✅   | Browse workspace structure, project organization, and documents                         |
 | `getListInfo`          |      ❌       |  ✅   |   ✅   | Get list details and available statuses for task creation                               |
-| `updateListInfo`       |      ❌       |  ❌   |   ✅   | **SAFE APPEND-ONLY** updates to list descriptions (preserves existing content)          |
+| `updateListInfo`       |      ❌       |  ❌   |   ✅   | Append to or replace list descriptions (previous content echoed back on replace)        |
 | `getTimeEntries`       |      ❌       |  ✅   |   ✅   | View time entries and analyze time spent across projects                                |
 | `createTimeEntry`      |      ❌       |  ❌   |   ✅   | Log time entries for task tracking                                                      |
+| `updateTimeEntry`      |      ❌       |  ❌   |   ✅   | Adjust your own time entries (duration, start, description, task)                       |
+| `deleteTimeEntry`      |      ❌       |  ❌   |   ✅   | Delete your own time entries (irreversible, values are echoed back)                     |
 | `readDocument`         |      ❌       |  ✅   |   ✅   | Get document details, page structure, and content with navigation                       |
 | `searchDocuments`      |      ❌       |  ✅   |   ✅   | Search documents by name and space with fuzzy matching and space filtering              |
 | `updateDocumentPage`   |      ❌       |  ❌   |   ✅   | Update existing page content or name with replace/append modes                          |
@@ -277,8 +280,8 @@ Create a task called "API Integration" with description:
 See related task: https://app.clickup.com/t/abc123
 ```
 
-**Append-Only Updates (Safe):**
-When updating task descriptions, content is safely appended:
+**Append or Replace Descriptions:**
+By default (`append_description`), content is appended under the existing description:
 ```markdown
 [Existing task description content]
 
@@ -288,7 +291,7 @@ When updating task descriptions, content is safely appended:
 - Performance requirement: < 2s load time
 ```
 
-This ensures no existing content is ever lost while maintaining a clear audit trail.
+This keeps existing content and a clear audit trail. To correct or restructure a description, `replace_description` rewrites it entirely; the tool answers with the previous description so nothing is silently lost. The same two parameters exist on `updateListInfo`.
 
 ## Writing Images Into Tickets
 

package/dist/cli.js

@@ -124,7 +124,7 @@ async function main() {
             // Try to parse as JSON if it looks like a JSON value
             try {
                 if (value.startsWith('{') || value.startsWith('[') ||
-                    value === 'true' || value === 'false' ||
+                    value === 'true' || value === 'false' || value === 'null' ||
                     (value.startsWith('"') && value.endsWith('"')) ||
                     (!isNaN(Number(value)) && !key.includes('id') && !value.startsWith('"'))) {
                     params[key] = JSON.parse(value);

package/dist/clickup-text.js

@@ -639,7 +639,24 @@ function walkMdastNodes(nodes, inheritedAttrs, blocks, depth = 0, attachmentsByS
                 }
                 break;
         }
+        // Keep the blank line the source puts between two blocks: remark drops it, and
+        // ClickUp would otherwise glue paragraphs and lists into one dense block
+        if (hasBlankLineBefore(nodes[i + 1], node)) {
+            blocks.push({ text: '\n', attributes: {} });
+        }
+    }
+}
+/**
+ * Whether the source has at least one blank line between `previous` and `next`.
+ * Several blank lines count as one, as in rendered markdown.
+ */
+function hasBlankLineBefore(next, previous) {
+    const previousEnd = previous.position?.end.line;
+    const nextStart = next?.position?.start.line;
+    if (previousEnd === undefined || nextStart === undefined) {
+        return false;
     }
+    return nextStart - previousEnd > 1;
 }
 /**
  * Recursively walk phrasing content (inline nodes) and build ClickUp blocks

package/dist/tools/list-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../src/tools/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAqHtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAiFvD"}
+{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../src/tools/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAqHtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAkGvD"}

package/dist/tools/list-tools.js

@@ -112,21 +112,27 @@ function registerListToolsWrite(server) {
     // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
     const tool = server.tool.bind(server);
     tool("updateListInfo", [
-        "Appends documentation or context to a list's description.",
+        "Appends to or replaces a list's description.",
         "ALWAYS reference the list URL (https://app.clickup.com/v/l/LIST_ID) when updating or discussing lists.",
-        "SAFETY FEATURE: Description updates are APPEND-ONLY to prevent data loss - existing content is preserved.",
+        "`append_description` adds a dated block under the existing description and is the safe default. `replace_description` rewrites the whole description - read it with getListInfo first and repeat everything worth keeping; the previous description is echoed back so it can be restored.",
         "Use this to add project context, requirements, or guidelines that LLMs should consider when working with tasks in this list.",
         "Include links to related tasks, spaces, or external resources in the appended content.",
         "Content is appended in markdown format with timestamp for tracking changes."
     ].join("\n"), {
         list_id: zod_1.z.string().min(1).describe("The list ID to update"),
-        append_description: zod_1.z.string().min(1).describe("Markdown content to APPEND to existing list description (preserves existing content for safety)")
+        append_description: zod_1.z.string().min(1).optional().describe("Markdown content to APPEND under the existing list description as a dated block (preserves existing content). Mutually exclusive with replace_description"),
+        replace_description: zod_1.z.string().optional().describe("Markdown content that REPLACES the whole list description. Anything not repeated here is lost (the previous description is echoed back). Mutually exclusive with append_description")
     }, {
         readOnlyHint: false,
-        destructiveHint: false,
+        destructiveHint: true,
         idempotentHint: false,
-    }, async ({ list_id, append_description }) => {
+    }, async ({ list_id, append_description, replace_description }) => {
         try {
+            if ((append_description === undefined) === (replace_description === undefined)) {
+                return {
+                    content: [{ type: "text", text: "Pass either append_description or replace_description (exactly one). The list was NOT updated." }],
+                };
+            }
             // Get current list info including description (try to get markdown content)
             const listResponse = await fetch(`https://api.clickup.com/api/v2/list/${list_id}?include_markdown_description=true`, {
                 headers: { Authorization: config_1.CONFIG.apiKey },
@@ -135,11 +141,17 @@ function registerListToolsWrite(server) {
                 throw new Error(`Error fetching list: ${listResponse.status} ${listResponse.statusText}`);
             }
             const listData = await listResponse.json();
-            // Handle append-only description update with markdown support
+            // Append adds a dated block under the current description; replace sends the new text as is
             const currentDescription = listData.markdown_description || listData.markdown_content || listData.content || "";
             const timestamp = new Date().toISOString().split('T')[0]; // YYYY-MM-DD format
-            const separator = currentDescription.trim() ? "\n\n---\n" : "";
-            const finalDescription = currentDescription + separator + `**Edit (${timestamp}):** ${append_description}`;
+            let finalDescription;
+            if (replace_description !== undefined) {
+                finalDescription = replace_description;
+            }
+            else {
+                const separator = currentDescription.trim() ? "\n\n---\n" : "";
+                finalDescription = currentDescription + separator + `**Edit (${timestamp}):** ${append_description}`;
+            }
             // Update the list description using markdown_content
             const updateResponse = await fetch(`https://api.clickup.com/api/v2/list/${list_id}`, {
                 method: 'PUT',
@@ -159,7 +171,12 @@ function registerListToolsWrite(server) {
                 content: [
                     {
                         type: "text",
-                        text: `Successfully appended content to list "${listData.name}". The new content has been added with timestamp (${timestamp}) while preserving existing description.`,
+                        text: replace_description !== undefined
+                            ? [
+                                `Successfully replaced the description of list "${listData.name}" (list_id: ${list_id}).`,
+                                `previous_description: ${currentDescription.trim() ? currentDescription : '(empty)'}`,
+                            ].join('\n')
+                            : `Successfully appended content to list "${listData.name}" (list_id: ${list_id}). The new content has been added with timestamp (${timestamp}) while preserving existing description.`,
                     },
                 ],
             };

package/dist/tools/task-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAyC,MAAM,iBAAiB,CAAC;AAOtF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAgErE;AA+MD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAmH/H"}
+{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAyC,MAAM,iBAAiB,CAAC;AAOtF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAgErE;AA+MD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAwH/H"}

package/dist/tools/task-tools.js

@@ -273,6 +273,10 @@ async function generateTaskMetadata(task, timeEntries, isDetailView = false) {
         const minutes = Math.floor((task.time_estimate % 3600000) / 60000);
         metadataLines.push(`time_estimate: ${hours}h ${minutes}m`);
     }
+    // Add sprint points if they exist
+    if (task.points !== undefined && task.points !== null) {
+        metadataLines.push(`points: ${task.points}`);
+    }
     // Add time booked (tracked time entries) - only if timeEntries provided
     if (timeEntries) {
         const timeBooked = filterTaskTimeEntries(task.id, timeEntries);

package/dist/tools/task-write-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-write-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-write-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsIpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAmnBtE"}
+{"version":3,"file":"task-write-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-write-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwIpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QA4sBtE"}

package/dist/tools/task-write-tools.js

@@ -93,7 +93,9 @@ const taskPrioritySchema = zod_1.z.enum(["urgent", "high", "normal", "low"]).opt
 const taskDueDateSchema = zod_1.z.string().optional().describe("Optional due date as ISO date string (e.g., '2024-10-06T23:59:59+02:00')");
 const taskStartDateSchema = zod_1.z.string().optional().describe("Optional start date as ISO date string (e.g., '2024-10-06T09:00:00+02:00')");
 const taskTimeEstimateSchema = zod_1.z.number().optional().describe("Optional time estimate in hours (will be converted to milliseconds)");
+const taskPointsSchema = zod_1.z.number().nonnegative().optional().describe("Optional sprint points - requires the Sprint Points ClickApp on the space. Valid values depend on the points scale configured in that workspace: ClickUp rejects any other value with 'not a valid points selection'");
 const taskTagsSchema = zod_1.z.array(zod_1.z.string()).optional().describe("Optional array of tag names");
+const CLEAR_HINT = " - pass null to clear the current value";
 function registerTaskToolsWrite(server, userData) {
     // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
     const tool = server.tool.bind(server);
@@ -269,12 +271,68 @@ function registerTaskToolsWrite(server, userData) {
             };
         }
     });
+    tool("deleteComment", [
+        "Deletes a task comment. This cannot be undone - the deleted text is echoed back so it can be re-posted with addComment if needed.",
+        `GUARDRAILS: same as editComment - only comments written by the API token's own user can be deleted, and only within ${config_1.CONFIG.commentEditWindowHours} hours of their creation. Replies inside a thread cannot be deleted.`,
+    ].join("\n"), {
+        task_id: zod_1.z.string().min(1).refine(val => (0, utils_1.isTaskId)(val) || (0, utils_1.isCustomTaskId)(val), {
+            message: "Must be an internal task ID (6+ alphanumeric characters) or a custom task ID (e.g. SOI-4422)"
+        }).describe("The ID of the task the comment belongs to - needed to locate the comment. Internal ID (e.g. \"869c4za0g\") or custom ID (e.g. \"SOI-4422\")"),
+        comment_id: zod_1.z.string().min(1).describe("The ID of the comment to delete, as returned by addComment or getTaskById"),
+    }, {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    }, async ({ task_id, comment_id }) => {
+        try {
+            const resolved_task_id = await (0, utils_1.resolveTaskId)(task_id);
+            const [existing, userData] = await Promise.all([
+                findTaskComment(resolved_task_id, comment_id),
+                (0, utils_1.getCurrentUser)(),
+            ]);
+            assertCommentIsEditable(existing, userData.user.id, 'deleted');
+            const response = await fetch(`https://api.clickup.com/api/v2/comment/${comment_id}`, {
+                method: 'DELETE',
+                headers: { Authorization: config_1.CONFIG.apiKey }
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                throw new Error(`Error deleting comment: ${response.status} ${response.statusText} - ${JSON.stringify(errorData)}`);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `Comment deleted successfully!`,
+                            `comment_id: ${comment_id}`,
+                            `task_id: ${resolved_task_id}`,
+                            `task_url: https://app.clickup.com/t/${resolved_task_id}`,
+                            `created: ${timestampToIso(existing.date)}`,
+                            `deleted_text: ${existing.comment_text || '(no plain text available)'}`,
+                        ].join('\n')
+                    }
+                ],
+            };
+        }
+        catch (error) {
+            console.error('Error deleting comment:', error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error deleting comment: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+            };
+        }
+    });
     tool("updateTask", (() => {
         const descriptionBase = [
             "Updates various aspects of an existing task including dependencies and relationships.",
             "ALWAYS include the task URL (https://app.clickup.com/t/TASK_ID) when updating or referencing tasks.",
             "Use getListInfo first to see valid status options.",
-            "SAFETY FEATURE: Description updates are APPEND-ONLY to prevent data loss - existing content is preserved.",
+            "DESCRIPTION: `append_description` adds a dated block under the existing description and is the safe default for notes. `replace_description` rewrites the whole description - use it to correct or restructure the specification. Read the current description with getTaskById first and repeat everything worth keeping; the previous description is echoed back so it can be restored with another call.",
             "STATUS UPDATES: Use the `addComment` tool for progress reports, work logs, and status updates rather than the task description.",
             IMAGE_SUPPORT_HINT,
             "Task descriptions should contain requirements, specifications, and core task information.",
@@ -291,15 +349,18 @@ function registerTaskToolsWrite(server, userData) {
             message: "Must be an internal task ID (6+ alphanumeric characters) or a custom task ID (e.g. SOI-4422)"
         }).describe("The task ID to update: internal ID (e.g. \"869c4za0g\") or custom ID (e.g. \"SOI-4422\")"),
         name: taskNameSchema.optional(),
-        append_description: zod_1.z.string().optional().describe("Optional markdown content to APPEND to existing task description (preserves existing content for safety)"),
+        append_description: zod_1.z.string().optional().describe("Optional markdown content to APPEND under the existing task description as a dated block (preserves existing content). Mutually exclusive with replace_description"),
+        replace_description: zod_1.z.string().optional().describe("Optional markdown content that REPLACES the whole task description. Anything not repeated here is lost (the previous description is echoed back in the response). Mutually exclusive with append_description"),
         status: zod_1.z.string().optional().describe("Optional new status name - use getListInfo to see valid options"),
         priority: taskPrioritySchema,
-        due_date: taskDueDateSchema,
-        start_date: taskStartDateSchema,
-        time_estimate: taskTimeEstimateSchema,
+        due_date: taskDueDateSchema.nullable().describe(taskDueDateSchema.description + CLEAR_HINT),
+        start_date: taskStartDateSchema.nullable().describe(taskStartDateSchema.description + CLEAR_HINT),
+        time_estimate: taskTimeEstimateSchema.nullable().describe(taskTimeEstimateSchema.description + CLEAR_HINT),
+        points: taskPointsSchema.nullable().describe(taskPointsSchema.description + CLEAR_HINT),
         tags: taskTagsSchema.describe("Optional array of tag names (will replace existing tags)"),
         parent_task_id: zod_1.z.string().optional().describe("Optional parent task ID to change parent/child relationships"),
-        assignees: zod_1.z.array(zod_1.z.string()).optional().describe(createAssigneeDescription(userData)),
+        assignees: zod_1.z.array(zod_1.z.string()).optional().describe("Optional array of user IDs to add as assignees - existing assignees are kept"),
+        remove_assignees: zod_1.z.array(zod_1.z.string()).optional().describe("Optional array of user IDs to unassign from the task. Combine with assignees to replace one assignee by another."),
         waiting_on: zod_1.z.array(zod_1.z.string()).optional().describe("Optional array of task IDs that this task should wait on (will replace existing waiting_on relationships)"),
         blocking: zod_1.z.array(zod_1.z.string()).optional().describe("Optional array of task IDs that this task should block. Note: This creates dependencies FROM those tasks TO this task (those tasks will wait on this one)"),
         linked_tasks: zod_1.z.array(zod_1.z.string()).optional().describe("Optional array of task IDs to link as related tasks without blocking (will replace existing linked tasks)")
@@ -308,8 +369,13 @@ function registerTaskToolsWrite(server, userData) {
         destructiveHint: true,
         idempotentHint: false,
         openWorldHint: true
-    }, async ({ task_id, name, append_description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees, blocking, waiting_on, linked_tasks }) => {
+    }, async ({ task_id, name, append_description, replace_description, status, priority, due_date, start_date, time_estimate, points, tags, parent_task_id, assignees, remove_assignees, blocking, waiting_on, linked_tasks }) => {
         try {
+            if (append_description !== undefined && replace_description !== undefined) {
+                return {
+                    content: [{ type: "text", text: "Pass either append_description or replace_description, not both. The task was NOT updated." }],
+                };
+            }
             // Resolve custom task ID to internal ID if needed
             const resolved_task_id = await (0, utils_1.resolveTaskId)(task_id);
             const userData = await (0, utils_1.getCurrentUser)();
@@ -324,15 +390,18 @@ function registerTaskToolsWrite(server, userData) {
             // Resolve and upload description images FIRST - an image problem must
             // abort before dependencies, tags or the task itself are touched, so the
             // caller can fix the markdown and retry the whole call cleanly.
-            let appendedDescription;
+            // Both description modes go through the same pipeline: only what is done
+            // with the prepared markdown differs (appended block vs whole description).
+            let preparedDescription;
             let uploadedImages = [];
-            if (append_description) {
+            const descriptionInput = replace_description !== undefined ? replace_description : append_description;
+            if (descriptionInput) {
                 const abortNotice = "the task was NOT updated";
-                const prepared = await resolveImagesOrAbort(append_description, abortNotice);
+                const prepared = await resolveImagesOrAbort(descriptionInput, abortNotice);
                 uploadedImages = await uploadImagesOrAbort(resolved_task_id, prepared.images, abortNotice);
                 // Descriptions render plain markdown, so no image fragments are involved
                 // here - the local paths are simply swapped for the CDN URLs.
-                appendedDescription = (0, clickup_text_1.rewriteMarkdownImageUrls)(prepared.markdown, (0, attachments_1.toAttachmentMap)(uploadedImages));
+                preparedDescription = (0, clickup_text_1.rewriteMarkdownImageUrls)(prepared.markdown, (0, attachments_1.toAttachmentMap)(uploadedImages));
             }
             // Handle dependencies separately since they need individual API calls
             let dependencyUpdateResults = [];
@@ -382,25 +451,29 @@ function registerTaskToolsWrite(server, userData) {
                     }
                 }
             }
-            // Handle append-only description update with markdown support
+            // Append adds a dated block under the current description; replace sends
+            // the prepared markdown as is. An empty replace_description clears it.
             let finalDescription;
-            if (appendedDescription !== undefined) {
-                const currentDescription = taskData.markdown_description || "";
+            const currentDescription = taskData.markdown_description || "";
+            if (replace_description !== undefined) {
+                finalDescription = preparedDescription ?? "";
+            }
+            else if (preparedDescription !== undefined) {
                 const timestamp = new Date().toISOString().split('T')[0]; // YYYY-MM-DD format
                 const separator = currentDescription.trim() ? "\n\n---\n" : "";
-                finalDescription = currentDescription + separator + `**Edit (${timestamp}):** ${appendedDescription}`;
+                finalDescription = currentDescription + separator + `**Edit (${timestamp}):** ${preparedDescription}`;
             }
             // Build update body without tags (they're handled separately)
             const updateBody = buildTaskRequestBody({
-                name, status, priority, due_date, start_date, time_estimate, parent_task_id, assignees
+                name, status, priority, due_date, start_date, time_estimate, points, parent_task_id, assignees
             });
             // Add markdown description if we have content to append
             if (finalDescription !== undefined) {
                 updateBody.markdown_description = finalDescription;
             }
-            // Handle assignees for updates (different from creates)
-            if (assignees !== undefined) {
-                updateBody.assignees = { add: assignees, rem: [] }; // Add new assignees, remove none
+            // Handle assignees for updates (different from creates) - ClickUp requires both add and rem
+            if (assignees !== undefined || remove_assignees !== undefined) {
+                updateBody.assignees = { add: assignees ?? [], rem: remove_assignees ?? [] };
             }
             // Check if there's anything to update (including tags and dependencies which were handled separately)
             if (Object.keys(updateBody).length === 0 && tags === undefined && blocking === undefined && waiting_on === undefined && linked_tasks === undefined) {
@@ -440,8 +513,12 @@ function registerTaskToolsWrite(server, userData) {
                 }
             }
             const responseLines = formatTaskResponse(updatedTask, 'updated', {
-                name, append_description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees, blocking, waiting_on, linked_tasks
+                name, append_description, status, priority, due_date, start_date, time_estimate, points, tags, parent_task_id, assignees, remove_assignees, blocking, waiting_on, linked_tasks
             }, userData);
+            // Echo what was overwritten so a wrong replacement can be undone with another call
+            if (replace_description !== undefined) {
+                responseLines.push(`previous_description: ${currentDescription.trim() ? currentDescription : '(empty)'}`);
+            }
             // Add dependency update results if any
             if (dependencyUpdateResults.length > 0) {
                 responseLines.push('dependency_warnings: ' + dependencyUpdateResults.join('; '));
@@ -498,6 +575,7 @@ function registerTaskToolsWrite(server, userData) {
         due_date: taskDueDateSchema,
         start_date: taskStartDateSchema,
         time_estimate: taskTimeEstimateSchema,
+        points: taskPointsSchema,
         tags: taskTagsSchema,
         parent_task_id: zod_1.z.string().optional().describe("Optional parent task ID to create this as a subtask"),
         assignees: zod_1.z.array(zod_1.z.string()).optional().describe(createAssigneeDescription(userData))
@@ -506,7 +584,7 @@ function registerTaskToolsWrite(server, userData) {
         destructiveHint: false,
         idempotentHint: false,
         openWorldHint: true
-    }, async ({ list_id, name, description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees }) => {
+    }, async ({ list_id, name, description, status, priority, due_date, start_date, time_estimate, points, tags, parent_task_id, assignees }) => {
         try {
             // Resolve description images BEFORE creating the task: a broken reference
             // (missing file, dead URL, non-image) must not leave a half-finished task
@@ -516,7 +594,7 @@ function registerTaskToolsWrite(server, userData) {
             const userData = await (0, utils_1.getCurrentUser)();
             const currentUserId = userData.user.id;
             const requestBody = buildTaskRequestBody({
-                name, status, priority, due_date, start_date, time_estimate, tags, assignees, parent_task_id
+                name, status, priority, due_date, start_date, time_estimate, points, tags, assignees, parent_task_id
             }, currentUserId);
             // Add markdown description if provided
             if (description) {
@@ -589,7 +667,7 @@ function registerTaskToolsWrite(server, userData) {
                 }
             }
             const responseLines = formatTaskResponse(createdTask, 'created', {
-                list_id, name, description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees
+                list_id, name, description, status, priority, due_date, start_date, time_estimate, points, tags, parent_task_id, assignees
             }, userData);
             responseLines.push(...formatAttachedImages(uploaded));
             responseLines.push(...imageWarnings);
@@ -712,17 +790,18 @@ async function findTaskComment(taskId, commentId) {
  * other people's comments safe, and the time window is what keeps the tool from
  * rewriting history.
  */
-function assertCommentIsEditable(comment, currentUserId) {
+function assertCommentIsEditable(comment, currentUserId, action = 'edited') {
     const windowHours = config_1.CONFIG.commentEditWindowHours;
+    const verb = action === 'deleted' ? 'Deleting' : 'Editing';
     if (!(windowHours > 0)) {
-        throw new Error(`Editing comments is disabled (CLICKUP_COMMENT_EDIT_WINDOW_HOURS=${windowHours}). Add a new comment instead.`);
+        throw new Error(`${verb} comments is disabled (CLICKUP_COMMENT_EDIT_WINDOW_HOURS=${windowHours}). Add a new comment instead.`);
     }
     if (String(comment.user?.id ?? '') !== String(currentUserId)) {
-        throw new Error(`Comment ${comment.id} was written by ${comment.user?.username || 'someone else'} (user_id: ${comment.user?.id ?? 'unknown'}), not by the current user (user_id: ${currentUserId}). Only your own comments can be edited - reply with a new comment instead.`);
+        throw new Error(`Comment ${comment.id} was written by ${comment.user?.username || 'someone else'} (user_id: ${comment.user?.id ?? 'unknown'}), not by the current user (user_id: ${currentUserId}). Only your own comments can be ${action} - reply with a new comment instead.`);
     }
     const ageHours = (Date.now() - Number(comment.date)) / (1000 * 60 * 60);
     if (ageHours > windowHours) {
-        throw new Error(`Comment ${comment.id} was created ${ageHours.toFixed(1)} hours ago (${timestampToIso(comment.date)}), which is outside the ${windowHours} hour edit window. Add a new comment instead of rewriting an old one.`);
+        throw new Error(`Comment ${comment.id} was created ${ageHours.toFixed(1)} hours ago (${timestampToIso(comment.date)}), which is outside the ${windowHours} hour edit window. Comments that old can no longer be ${action} - add a new comment instead.`);
     }
 }
 /**
@@ -754,14 +833,19 @@ function buildTaskRequestBody(params, currentUserId) {
     if (params.priority !== undefined) {
         requestBody.priority = convertPriorityToNumber(params.priority);
     }
+    // null clears the value - it must be sent as is, new Date(null) would set 1970-01-01.
+    // time_estimate is the exception: ClickUp accepts null but silently keeps the estimate, only 0 clears it.
     if (params.due_date !== undefined) {
-        requestBody.due_date = new Date(params.due_date).getTime();
+        requestBody.due_date = params.due_date === null ? null : new Date(params.due_date).getTime();
     }
     if (params.start_date !== undefined) {
-        requestBody.start_date = new Date(params.start_date).getTime();
+        requestBody.start_date = params.start_date === null ? null : new Date(params.start_date).getTime();
     }
     if (params.time_estimate !== undefined) {
-        requestBody.time_estimate = Math.round(params.time_estimate * 60 * 60 * 1000);
+        requestBody.time_estimate = params.time_estimate === null ? 0 : Math.round(params.time_estimate * 60 * 60 * 1000);
+    }
+    if (params.points !== undefined) {
+        requestBody.points = params.points;
     }
     // Tags are handled separately via dedicated API endpoints
     // Do not include in the update request body
@@ -891,14 +975,20 @@ function formatTaskResponse(task, operation, params, userData) {
             params.priority ? params.priority : 'unknown';
         responseLines.push(`priority: ${priority}`);
     }
+    if (params.remove_assignees !== undefined && params.remove_assignees.length > 0) {
+        responseLines.push(`removed_assignees: ${params.remove_assignees.join(', ')}`);
+    }
     if (params.due_date !== undefined) {
-        responseLines.push(`due_date: ${params.due_date}`);
+        responseLines.push(`due_date: ${params.due_date ?? 'cleared'}`);
     }
     if (params.start_date !== undefined) {
-        responseLines.push(`start_date: ${params.start_date}`);
+        responseLines.push(`start_date: ${params.start_date ?? 'cleared'}`);
     }
     if (params.time_estimate !== undefined) {
-        responseLines.push(`time_estimate: ${formatTimeEstimate(params.time_estimate)}`);
+        responseLines.push(`time_estimate: ${params.time_estimate === null ? 'cleared' : formatTimeEstimate(params.time_estimate)}`);
+    }
+    if (params.points !== undefined) {
+        responseLines.push(`points: ${params.points === null ? 'cleared' : task.points ?? params.points}`);
     }
     if (params.tags !== undefined && params.tags.length > 0) {
         responseLines.push(`tags: ${params.tags.join(', ')}`);

package/dist/tools/time-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-tools.d.ts","sourceRoot":"","sources":["../../src/tools/time-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyDpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAqFtD;AAyLD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAgGvD"}
+{"version":3,"file":"time-tools.d.ts","sourceRoot":"","sources":["../../src/tools/time-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyDpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAqFtD;AA6OD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAmPvD"}

package/dist/tools/time-tools.js

@@ -248,7 +248,8 @@ function processTimeEntriesData(data, task_id, start_date, end_date, include_all
                             entryDuration = formatDuration(rawDuration);
                         }
                         const entryDescription = entry.description ? ` | ${entry.description}` : '';
-                        outputLines.push(`${entryPrefix} ${entryStart} - ${entryDuration}${entryDescription}`);
+                        // The id is what updateTimeEntry/deleteTimeEntry need to target an entry
+                        outputLines.push(`${entryPrefix} ${entryStart} - ${entryDuration} (entry_id: ${entry.id})${entryDescription}`);
                     });
                 }
             }
@@ -264,9 +265,173 @@ function processTimeEntriesData(data, task_id, start_date, end_date, include_all
         ],
     };
 }
+/**
+ * Reads a single time entry. GET /time_entries/{id} answers `{"data": null}`
+ * with a 200 for an unknown or already deleted id, hence the explicit check.
+ */
+async function fetchTimeEntry(entryId) {
+    const response = await fetch(`https://api.clickup.com/api/v2/team/${config_1.CONFIG.teamId}/time_entries/${entryId}`, {
+        headers: { Authorization: config_1.CONFIG.apiKey },
+    });
+    if (!response.ok) {
+        throw new Error(`Error fetching time entry ${entryId}: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (!data.data) {
+        throw new Error(`Time entry ${entryId} was not found. Use getTimeEntries to list existing entries and their entry_id.`);
+    }
+    return data.data;
+}
+/**
+ * The safety model of updateTimeEntry/deleteTimeEntry: getTimeEntries can list
+ * other members' entries (include_all_users), so the owner check is what keeps
+ * a wrong entry_id from touching a colleague's time. A running timer is refused
+ * too - its duration is negative and its end does not exist yet.
+ */
+function assertTimeEntryIsOwn(entry, currentUserId, action) {
+    if (String(entry.user?.id ?? '') !== String(currentUserId)) {
+        throw new Error(`Time entry ${entry.id} belongs to ${entry.user?.username || 'someone else'} (user_id: ${entry.user?.id ?? 'unknown'}), not to the current user (user_id: ${currentUserId}). Only your own time entries can be ${action}.`);
+    }
+    if (parseInt(entry.duration) < 0) {
+        throw new Error(`Time entry ${entry.id} is a running timer. Stop it in ClickUp before trying to ${action === 'deleted' ? 'delete' : 'update'} it.`);
+    }
+}
+function formatTimeEntryLines(entry) {
+    return [
+        `entry_id: ${entry.id}`,
+        `task: ${entry.task?.name || 'No Task'} (task_id: ${entry.task?.id || 'none'})`,
+        `start_time: ${timestampToIso(parseInt(entry.start))}`,
+        `duration: ${formatDuration(parseInt(entry.duration) || 0)}`,
+        ...(entry.description ? [`description: ${entry.description}`] : []),
+        `user: ${entry.user?.username || 'Unknown User'} (user_id: ${entry.user?.id ?? 'unknown'})`,
+    ];
+}
 function registerTimeToolsWrite(server) {
     // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
     const tool = server.tool.bind(server);
+    tool("updateTimeEntry", [
+        "Updates an existing time entry: duration, start time, description or the task it is booked on.",
+        "Use getTimeEntries first to find the entry_id. Only fields provided are changed.",
+        "GUARDRAILS: only time entries of the API token's own user can be updated, and running timers are refused.",
+        "Use decimal hours for the duration (e.g., 0.25 for 15 minutes, 1.5 for 1h 30min)."
+    ].join("\n"), {
+        entry_id: zod_1.z.string().min(1).describe("The time entry ID (entry_id shown by getTimeEntries)"),
+        hours: zod_1.z.number().min(0.01).max(24).optional().describe("New duration in decimal hours (e.g., 0.25 = 15min, 1.5 = 1h 30min)"),
+        start_time: zod_1.z.string().optional().describe("New start time as ISO date string (e.g., '2024-10-06T09:00:00+02:00'); the end is recomputed from the duration"),
+        description: zod_1.z.string().optional().describe("New description (pass an empty string to clear it)"),
+        task_id: zod_1.z.string().min(1).refine(val => (0, utils_1.isTaskId)(val) || (0, utils_1.isCustomTaskId)(val), {
+            message: "Must be an internal task ID (6+ alphanumeric characters) or a custom task ID (e.g. SOI-4422)"
+        }).optional().describe("Move the entry to another task: internal ID (e.g. \"869c4za0g\") or custom ID (e.g. \"SOI-4422\")")
+    }, {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+    }, async ({ entry_id, hours, start_time, description, task_id }) => {
+        try {
+            if (hours === undefined && start_time === undefined && description === undefined && task_id === undefined) {
+                return {
+                    content: [{ type: "text", text: "No updates provided. Please specify at least one of hours, start_time, description or task_id." }],
+                };
+            }
+            const userData = await (0, utils_1.getCurrentUser)();
+            const existing = await fetchTimeEntry(entry_id);
+            assertTimeEntryIsOwn(existing, userData.user.id, 'updated');
+            // ClickUp leaves `end` untouched when only `start` is sent, which makes the
+            // entry inconsistent - so start, end and duration are always sent together.
+            const startMs = start_time !== undefined ? isoToTimestamp(start_time) : parseInt(existing.start);
+            const durationMs = hours !== undefined ? Math.round(hours * 60 * 60 * 1000) : parseInt(existing.duration);
+            const requestBody = {
+                start: startMs,
+                end: startMs + durationMs,
+                duration: durationMs,
+                ...(description !== undefined && { description }),
+                ...(task_id !== undefined && { tid: await (0, utils_1.resolveTaskId)(task_id) }),
+            };
+            const response = await fetch(`https://api.clickup.com/api/v2/team/${config_1.CONFIG.teamId}/time_entries/${entry_id}`, {
+                method: 'PUT',
+                headers: {
+                    Authorization: config_1.CONFIG.apiKey,
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(requestBody)
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                throw new Error(`Error updating time entry: ${response.status} ${response.statusText} - ${JSON.stringify(errorData)}`);
+            }
+            // PUT answers `{"data": [entry]}` - fall back to what was sent if the shape differs
+            const responseData = await response.json();
+            const updated = Array.isArray(responseData.data) ? responseData.data[0] : responseData.data;
+            const finalEntry = { ...existing, ...requestBody, ...(updated || {}), task: updated?.task || existing.task };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [`Time entry updated successfully!`, ...formatTimeEntryLines(finalEntry)].join('\n')
+                    }
+                ],
+            };
+        }
+        catch (error) {
+            console.error('Error updating time entry:', error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error updating time entry: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+            };
+        }
+    });
+    tool("deleteTimeEntry", [
+        "Deletes a time entry. This cannot be undone - check the entry with getTimeEntries first.",
+        "GUARDRAILS: only time entries of the API token's own user can be deleted, and running timers are refused.",
+        "The response echoes the deleted values so the entry can be recreated with createTimeEntry if needed."
+    ].join("\n"), {
+        entry_id: zod_1.z.string().min(1).describe("The time entry ID (entry_id shown by getTimeEntries)")
+    }, {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+    }, async ({ entry_id }) => {
+        try {
+            const userData = await (0, utils_1.getCurrentUser)();
+            const existing = await fetchTimeEntry(entry_id);
+            assertTimeEntryIsOwn(existing, userData.user.id, 'deleted');
+            const response = await fetch(`https://api.clickup.com/api/v2/team/${config_1.CONFIG.teamId}/time_entries/${entry_id}`, {
+                method: 'DELETE',
+                headers: {
+                    Authorization: config_1.CONFIG.apiKey,
+                    'Content-Type': 'application/json'
+                }
+            });
+            if (!response.ok) {
+                const errorData = await response.json().catch(() => ({}));
+                throw new Error(`Error deleting time entry: ${response.status} ${response.statusText} - ${JSON.stringify(errorData)}`);
+            }
+            // DELETE answers an empty object, so the values come from the entry read beforehand
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [`Time entry deleted successfully!`, ...formatTimeEntryLines(existing)].join('\n')
+                    }
+                ],
+            };
+        }
+        catch (error) {
+            console.error('Error deleting time entry:', error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error deleting time entry: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+            };
+        }
+    });
     tool("createTimeEntry", [
         "Creates a time entry (books time) on a task for the current user.",
         "Use decimal hours (e.g., 0.25 for 15 minutes, 0.5 for 30 minutes, 2.5 for 2.5 hours).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sebastienheyd/clickup-mcp",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Search, create, and retrieve tasks, add comments, and track time through natural language commands.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",