@hauptsache.net/clickup-mcp 1.6.0 → 1.6.2

package/README.md

@@ -2,6 +2,34 @@
 
 Model Context Protocol (MCP) server enabling AI assistants to interact with ClickUp workspaces. Get complete task context with comments and images, search across projects, create and update tasks, collaborate through comments, and track time - all through natural language.
 
+## This MCP vs Official ClickUp MCP
+
+> See also: [Official ClickUp MCP Documentation](https://developer.clickup.com/docs/connect-an-ai-assistant-to-clickups-mcp-server)
+
+| Feature              | This MCP                                              | Official ClickUp MCP                        |
+|----------------------|-------------------------------------------------------|---------------------------------------------|
+| **Setup**            | Local npm/npx install                                 | Remote MCP (no install)                     |
+| **Authentication**   | API key only                                          | OAuth only                                  |
+| **Task Context**     | Complete with comments, status history, inline images | Requires mutiple tool calls for full contxt |
+| **Image Support**    | Inline images with smart size budgeting               | Not documented                              |
+| **Search**           | Fuzzy search on recent tasks (limited scope)          | Full ClickUp search database                |
+| **Documents**        | CRUD operations                                       | CRUD + document search                      |
+| **Time Tracking**    | View and create entries                               | Timers and entries                          |
+| **Chat Integration** | Not supported                                         | Supported                                   |
+| **Connected Apps**   | Not supported                                         | Connected Search                            |
+| **Best For**         | Coding tools, automation, context gathering           | Chat apps, task management                  |
+| **Support**          | Community (open source)                               | Official ClickUp                            |
+
+**Choose this MCP when:**
+- You need rich task context with inline images for AI coding tools
+- You need API key authentication for automation or CI/CD pipelines
+- You want the `read-minimal` mode optimized for development workflows
+
+**Choose Official MCP when:**
+- You need OAuth authentication for enterprise security compliance
+- You need Chat integration or Connected Search features
+- You want official support and no local installation
+
 ## What You Can Do
 
 Turn natural language into powerful ClickUp actions:

package/dist/shared/image-processing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-processing.d.ts","sourceRoot":"","sources":["../../src/shared/image-processing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAKzD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE,EAAE,SAAS,GAAE,MAAyB,EAAE,SAAS,GAAE,MAAiC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA0BhM"}
+{"version":3,"file":"image-processing.d.ts","sourceRoot":"","sources":["../../src/shared/image-processing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAC;AAmDzD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE,EAAE,SAAS,GAAE,MAAyB,EAAE,SAAS,GAAE,MAAiC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA0BhM"}

package/dist/shared/image-processing.js

@@ -4,6 +4,46 @@ exports.downloadImages = downloadImages;
 const config_1 = require("./config");
 const data_uri_1 = require("./data-uri");
 const buffer_1 = require("buffer");
+/**
+ * Detect MIME type from image binary data using magic bytes (file signatures)
+ * Returns null if the format is not recognized
+ */
+function detectMimeTypeFromBuffer(buffer) {
+    const bytes = new Uint8Array(buffer);
+    if (bytes.length < 12)
+        return null;
+    // PNG: 89 50 4E 47 (‰PNG)
+    if (bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4E && bytes[3] === 0x47) {
+        return "image/png";
+    }
+    // JPEG: FF D8 FF
+    if (bytes[0] === 0xFF && bytes[1] === 0xD8 && bytes[2] === 0xFF) {
+        return "image/jpeg";
+    }
+    // GIF: 47 49 46 38 (GIF8)
+    if (bytes[0] === 0x47 && bytes[1] === 0x49 && bytes[2] === 0x46 && bytes[3] === 0x38) {
+        return "image/gif";
+    }
+    // WebP: RIFF....WEBP
+    if (bytes[0] === 0x52 && bytes[1] === 0x49 && bytes[2] === 0x46 && bytes[3] === 0x46 &&
+        bytes[8] === 0x57 && bytes[9] === 0x45 && bytes[10] === 0x42 && bytes[11] === 0x50) {
+        return "image/webp";
+    }
+    return null;
+}
+/**
+ * Detect MIME type from base64-encoded image data
+ * Decodes just enough bytes to check magic numbers
+ */
+function detectMimeTypeFromBase64(base64Data) {
+    // Need at least 16 base64 chars to decode 12 bytes for magic number detection
+    if (base64Data.length < 16)
+        return null;
+    // Create a Uint8Array directly from the decoded bytes to avoid Buffer pooling issues
+    const header = buffer_1.Buffer.from(base64Data.slice(0, 16), "base64");
+    const bytes = new Uint8Array(header);
+    return detectMimeTypeFromBuffer(bytes.buffer);
+}
 /**
  * Downloads images from image_metadata blocks and applies smart size/count limiting
  * Prioritizes keeping the most recent images (assumes content is ordered with newest items last)
@@ -98,9 +138,12 @@ async function downloadSingleImage(imageMetadata, perImageBudget) {
             const actualSizeBytes = imageBuffer.byteLength;
             // Double-check actual size (in case Content-Length was missing or incorrect)
             if (actualSizeBytes <= perImageBudget) {
+                // Detect actual MIME type from binary data, fall back to header or default
+                const detectedMimeType = detectMimeTypeFromBuffer(imageBuffer);
+                const mimeType = detectedMimeType || response.headers.get("Content-Type") || "image/png";
                 return {
                     type: "image",
-                    mimeType: response.headers.get("Content-Type") || "image/png",
+                    mimeType,
                     data: buffer_1.Buffer.from(imageBuffer).toString("base64"),
                 };
             }
@@ -145,9 +188,12 @@ function convertInlineImage(imageMetadata, perImageBudget) {
         console.error(`Inline image for "${imageMetadata.alt}" is ${estimatedSize} bytes, exceeds budget of ${perImageBudget} bytes`);
         return createImageFallback(imageMetadata);
     }
+    // Detect actual MIME type from binary data, fall back to declared type or default
+    const detectedMimeType = detectMimeTypeFromBase64(inlineData.base64Data);
+    const mimeType = detectedMimeType || inlineData.mimeType || "image/png";
     return {
         type: "image",
-        mimeType: inlineData.mimeType || "image/png",
+        mimeType,
         data: inlineData.base64Data,
     };
 }

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,QA2DrE;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,CA+G/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,QA2DrE;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"}

package/dist/tools/task-tools.js

@@ -229,9 +229,14 @@ async function generateTaskMetadata(task, timeEntries, isDetailView = false) {
     let spaceName = task.space?.name || 'Unknown Space';
     let spaceIdForDisplay = task.space?.id || 'N/A';
     if (spaceName === 'Unknown Space' && task.space?.id) {
-        const spaceDetails = await (0, utils_1.getSpaceDetails)(task.space.id);
-        if (spaceDetails && spaceDetails.name) {
-            spaceName = spaceDetails.name;
+        try {
+            const spaceDetails = await (0, utils_1.getSpaceDetails)(task.space.id);
+            if (spaceDetails && spaceDetails.name) {
+                spaceName = spaceDetails.name;
+            }
+        }
+        catch {
+            // Space details fetch can fail (e.g. 401) - gracefully keep "Unknown Space"
         }
     }
     const metadataLines = [

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,QAgFtD;AAwLD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAwFvD"}
+{"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,QAgFtD;AAyLD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAwFvD"}

package/dist/tools/time-tools.js

@@ -243,7 +243,8 @@ function processTimeEntriesData(data, task_id, start_date, end_date, include_all
                         else {
                             entryDuration = formatDuration(rawDuration);
                         }
-                        outputLines.push(`${entryPrefix} ${entryStart} - ${entryDuration}`);
+                        const entryDescription = entry.description ? ` | ${entry.description}` : '';
+                        outputLines.push(`${entryPrefix} ${entryStart} - ${entryDuration}${entryDescription}`);
                     });
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hauptsache.net/clickup-mcp",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Search, create, and retrieve tasks, add comments, and track time through natural language commands.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -40,7 +40,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.15.1",
+    "@modelcontextprotocol/sdk": "1.15.1",
     "fuse.js": "^7.1.0",
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",