@d4works/mcp-clickup 0.1.0 → 0.2.0

package/README.md

@@ -49,7 +49,7 @@ Then configure `.mcp.json` to source this file before running the server:
       "command": "bash",
       "args": [
         "-c",
-        "source .claude/.env.local && npx -y @d4works/mcp-clickup"
+        "export $(cat .claude/.env.local | xargs) && npx -y @d4works/mcp-clickup"
       ],
       "env": {
         "CLICKUP_TEAM_ID": "your_team_id",
@@ -129,6 +129,16 @@ Set the Release dropdown value on a ClickUp task. Only used with explicit user c
 - `release` (string, required): Release value to set (must match one of the available options)
 - `fieldName` (string, optional): Name of the dropdown field (default: "Release")
 
+### `add-task-comment`
+
+Add a comment to a ClickUp task. Only used with explicit user confirmation.
+
+**Parameters:**
+
+- `taskId` (string, required): Task URL, custom ID (ABC-123), or number
+- `comment` (string, required): The comment text to add to the task
+- `notifyAll` (boolean, optional): Notify all task members about the comment (default: false)
+
 ## License
 
 MIT

package/dist/clickup.d.ts

@@ -135,6 +135,12 @@ export declare class ClickUpClient {
      * Update custom field value on a task
      */
     updateCustomField(taskId: string, fieldId: string, value: unknown, isCustomId?: boolean): Promise<void>;
+    /**
+     * Add a comment to a task
+     */
+    addTaskComment(taskId: string, commentText: string, notifyAll?: boolean, isCustomId?: boolean): Promise<{
+        id: string;
+    }>;
     /**
      * Get dropdown custom field options (e.g., for Release field)
      */

package/dist/clickup.js

@@ -126,6 +126,18 @@ export class ClickUpClient {
             body: JSON.stringify({ value }),
         });
     }
+    /**
+     * Add a comment to a task
+     */
+    async addTaskComment(taskId, commentText, notifyAll = false, isCustomId = false) {
+        const endpoint = isCustomId
+            ? `/task/${taskId}/comment?custom_task_ids=true&team_id=${this.teamId}`
+            : `/task/${taskId}/comment`;
+        return this.request(endpoint, {
+            method: "POST",
+            body: JSON.stringify({ comment_text: commentText, notify_all: notifyAll }),
+        });
+    }
     /**
      * Get dropdown custom field options (e.g., for Release field)
      */

package/dist/index.js

@@ -122,6 +122,28 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ["taskId", "release"],
                 },
             },
+            {
+                name: "add-task-comment",
+                description: "Add a comment to a ClickUp task. IMPORTANT: Only use with explicit user confirmation!",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        taskId: {
+                            type: "string",
+                            description: "Task identifier: URL, custom ID (ABC-123), or number",
+                        },
+                        comment: {
+                            type: "string",
+                            description: "The comment text to add to the task",
+                        },
+                        notifyAll: {
+                            type: "boolean",
+                            description: "Notify all task members about the comment (default: false)",
+                        },
+                    },
+                    required: ["taskId", "comment"],
+                },
+            },
         ],
     };
 });
@@ -395,6 +417,32 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             };
         }
     }
+    if (name === "add-task-comment") {
+        const { taskId: rawTaskId, comment, notifyAll = false } = args;
+        const taskId = parseTaskId(rawTaskId);
+        try {
+            const result = await clickup.addTaskComment(taskId, comment, notifyAll, isCustomTaskId(taskId));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Comment added to task ${taskId} (comment ID: ${result.id})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error adding comment: ${error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
     throw new Error(`Unknown tool: ${name}`);
 });
 // Start the server

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d4works/mcp-clickup",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for ClickUp task management",
   "type": "module",
   "main": "dist/index.js",