@hauptsache.net/clickup-mcp 1.4.1 → 1.4.3

package/README.md

@@ -74,38 +74,81 @@ Turn natural language into powerful ClickUp actions:
 - **Append-Only Descriptions**: Description fields are never overwritten - new content is safely appended with timestamps
 - **Normal Field Updates**: Status, priority, assignees, tags, and dates can be updated normally (easily revertible through ClickUp's history)
 
-## Setup for Claude Desktop, Windsurf, or Cursor
-
-1. **Prerequisites**:
-   - Your `CLICKUP_API_KEY` (Profile Icon > Settings > Apps > API Token ~ usually starts with pk_)
-   - and your `CLICKUP_TEAM_ID` (The ~7 digit number in the url when you are in the settings)
-
-2. **Configuration**:
-   Add the following to your MCP configuration file:
-
-   ```json
-   {
-     "mcpServers": {
-       "clickup": {
-         "command": "npx",
-         "args": [
-           "@hauptsache.net/clickup-mcp@latest"
-         ],
-         "env": {
-           "CLICKUP_API_KEY": "your_api_key",
-           "CLICKUP_TEAM_ID": "your_team_id"
-         }
-       }
-     }
-   }
-   ```
-
-   Replace `your_api_key` and `your_team_id` with your actual ClickUp credentials.
-
-3. **Connect Your AI Assistant**:
-   - **Claude Desktop**: Add this configuration in Settings > Developer > Edit Config
-   - **Windsurf**: Add to your MCP configuration file
-   - **Cursor**: Configure through the MCP settings panel
+## Installation
+
+### Prerequisites
+
+For all installation methods, you'll need:
+- Your `CLICKUP_API_KEY` (Profile Icon > Settings > Apps > API Token ~ usually starts with pk_)
+- Your `CLICKUP_TEAM_ID` (The 7–10 digit number in the URL when you are in the settings)
+
+### Option 1: MCPB Bundle (Recommended for Claude Desktop)
+
+Download the pre-built bundle from our [releases page](https://github.com/hauptsacheNet/clickup-mcp/releases). This method requires no Node.js installation.
+
+You'll get a configuration screen where you are prompted to enter your API key and team ID.
+
+### Option 2: NPX Installation
+
+This method automatically updates to the latest version and is preferred for users who want the newest features.
+
+**For Claude Desktop, Windsurf, Cursor and others:**
+
+Add the following to your MCP configuration file:
+
+```json
+{
+  "mcpServers": {
+    "clickup": {
+      "command": "npx",
+      "args": [
+        "@hauptsache.net/clickup-mcp@latest"
+      ],
+      "env": {
+        "CLICKUP_API_KEY": "your_api_key",
+        "CLICKUP_TEAM_ID": "your_team_id"
+      }
+    }
+  }
+}
+```
+
+Replace `your_api_key` and `your_team_id` with your actual ClickUp credentials.
+
+**Where to add this configuration:**
+- **Claude Desktop**: Settings > Developer > Edit Config
+- **Windsurf**: Add to your MCP configuration file
+- **Cursor**: Configure through the MCP settings panel
+
+### Option 3: Coding Tools Integration
+
+**Claude Code (CLI):**
+```bash
+claude mcp add clickup \
+  --env CLICKUP_API_KEY=YOUR_KEY \
+  --env CLICKUP_TEAM_ID=YOUR_ID \
+  --env CLICKUP_MCP_MODE=read-minimal \
+  --env MAX_IMAGES=16 \
+  --env MAX_RESPONSE_SIZE_MB=4 \
+  -- npx -y @hauptsache.net/clickup-mcp
+```
+
+> Claude Code can handle a lot of images, thus the recommended increased limits.
+ 
+> Note the `CLICKUP_MCP_MODE=read-minimal`. This is my usage recommendation, but feel free to use one of the other modes.
+
+**OpenAI Codex:**
+Add these lines to your `~/.codex/config.toml` file:
+```toml
+[mcp_servers.clickup]
+command = "npx"
+args = ["-y", "@hauptsache.net/clickup-mcp@latest"]
+env = { "CLICKUP_API_KEY" = "YOUR_KEY", "CLICKUP_TEAM_ID" = "YOUR_ID", "CLICKUP_MCP_MODE" = "read-minimal" }
+```
+
+> Codex seems to not be able to handle images from MCP's. See [this issue](https://github.com/openai/codex/issues/3741) for more details.
+
+> Note the `CLICKUP_MCP_MODE=read-minimal`. This is my usage recommendation, but feel free to use one of the other modes.
 
 ## MCP Modes & Available Tools
 

package/dist/clickup-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clickup-text.d.ts","sourceRoot":"","sources":["../src/clickup-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AA4BD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,eAAe,EAAE,GAC3B,OAAO,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAiErE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GAClD,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAyG5D"}
+{"version":3,"file":"clickup-text.d.ts","sourceRoot":"","sources":["../src/clickup-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AA4BD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,eAAe,EAAE,GAC3B,OAAO,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAkGrE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GAClD,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CA0I5D"}

package/dist/clickup-text.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.processClickUpText = processClickUpText;
 exports.processClickUpMarkdown = processClickUpMarkdown;
+const data_uri_1 = require("./shared/data-uri");
 /**
  * Extract thumbnail URLs from data-attachment attribute JSON
  * ClickUp API sometimes has broken thumbnail URLs, but data-attachment contains working ones
@@ -37,9 +38,38 @@ async function processClickUpText(textItems) {
         const item = textItems[i];
         // Handle image items
         if (item.type === "image" && item.image && item.image.url) {
-            // Add image URL reference inline to current text block
             const imageFileName = item.image.name || item.image.title || "image";
-            currentTextBlock += `\nImage: ${imageFileName} - ${item.image.url}`;
+            const imageUrl = item.image.url;
+            const altText = item.text || imageFileName;
+            if (imageUrl.startsWith("data:")) {
+                const parsedData = (0, data_uri_1.parseDataUri)(imageUrl);
+                currentTextBlock += `\nImage: ${imageFileName} - [inline image data]`;
+                if (currentTextBlock.trim()) {
+                    contentBlocks.push({
+                        type: "text",
+                        text: currentTextBlock.trim(),
+                    });
+                }
+                currentTextBlock = "";
+                if (parsedData) {
+                    contentBlocks.push({
+                        type: "image_metadata",
+                        urls: [],
+                        alt: altText,
+                        inlineData: parsedData,
+                    });
+                }
+                else {
+                    console.error(`Unable to parse inline image data for ${imageFileName}`);
+                    contentBlocks.push({
+                        type: "text",
+                        text: `[Image "${altText}" omitted: unsupported inline data URI]`,
+                    });
+                }
+                continue;
+            }
+            // Add image URL reference inline to current text block
+            currentTextBlock += `\nImage: ${imageFileName} - ${imageUrl}`;
             // Get working thumbnail URLs from data-attachment if available
             const extractedThumbnails = extractThumbnailsFromDataAttachment(item.attributes);
             // Determine best thumbnail URLs (prefer extracted over API thumbnails)
@@ -63,7 +93,7 @@ async function processClickUpText(textItems) {
                 contentBlocks.push({
                     type: "image_metadata",
                     urls: urls,
-                    alt: item.text || imageFileName,
+                    alt: altText,
                 });
             }
             // If no thumbnails, just treat as a file reference (already added to currentTextBlock)
@@ -110,6 +140,35 @@ function processClickUpMarkdown(markdownText, attachments) {
         const [fullMatch, altText, imageUrl] = match;
         // Add text before the image reference to the current text block
         currentTextBlock += markdownText.substring(lastIndex, match.index);
+        if (imageUrl.startsWith("data:")) {
+            const imageFileName = altText || "image";
+            const parsedData = (0, data_uri_1.parseDataUri)(imageUrl);
+            currentTextBlock += `\nImage: ${imageFileName} - [inline image data]`;
+            if (currentTextBlock.trim()) {
+                contentBlocks.push({
+                    type: "text",
+                    text: currentTextBlock.trim(),
+                });
+            }
+            currentTextBlock = "";
+            if (parsedData) {
+                contentBlocks.push({
+                    type: "image_metadata",
+                    urls: [],
+                    alt: altText || imageFileName,
+                    inlineData: parsedData,
+                });
+            }
+            else {
+                console.error(`Unable to parse inline image data for ${imageFileName}`);
+                contentBlocks.push({
+                    type: "text",
+                    text: `[Image "${altText || imageFileName}" omitted: unsupported inline data URI]`,
+                });
+            }
+            lastIndex = match.index + fullMatch.length;
+            continue;
+        }
         // Check if this image URL exists in our attachments
         const attachment = attachmentMap.get(imageUrl);
         if (attachment) {

package/dist/resources/space-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"space-resources.d.ts","sourceRoot":"","sources":["../../src/resources/space-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAiBtF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAuFvD"}
+{"version":3,"file":"space-resources.d.ts","sourceRoot":"","sources":["../../src/resources/space-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAiBtF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAwFvD"}

package/dist/resources/space-resources.js

@@ -35,6 +35,7 @@ function registerSpaceResources(server) {
                     resources: activeSpaces.map((space) => ({
                         uri: `clickup://space/${space.id}`,
                         name: space.name,
+                        title: space.name,
                         mimeType: "text/plain"
                     }))
                 };

package/dist/shared/data-uri.d.ts

@@ -0,0 +1,14 @@
+export interface ParsedDataUri {
+    mimeType: string;
+    base64Data: string;
+}
+/**
+ * Parse data URI strings of the form data:mime/type;base64,....
+ * Returns null if the value is not a base64 data URI.
+ */
+export declare function parseDataUri(dataUri: string): ParsedDataUri | null;
+/**
+ * Estimate the decoded byte-size of base64 data without allocating buffers
+ */
+export declare function estimateBase64Size(base64Data: string): number;
+//# sourceMappingURL=data-uri.d.ts.map

package/dist/shared/data-uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-uri.d.ts","sourceRoot":"","sources":["../../src/shared/data-uri.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAoBlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI7D"}

package/dist/shared/data-uri.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDataUri = parseDataUri;
+exports.estimateBase64Size = estimateBase64Size;
+/**
+ * Parse data URI strings of the form data:mime/type;base64,....
+ * Returns null if the value is not a base64 data URI.
+ */
+function parseDataUri(dataUri) {
+    if (!dataUri.startsWith("data:")) {
+        return null;
+    }
+    const match = dataUri.match(/^data:([^;]+);base64,(.+)$/s);
+    if (!match) {
+        return null;
+    }
+    const [, mimeType, base64Part] = match;
+    const sanitizedBase64 = base64Part.replace(/\s+/g, "");
+    if (!sanitizedBase64) {
+        return null;
+    }
+    return {
+        mimeType,
+        base64Data: sanitizedBase64,
+    };
+}
+/**
+ * Estimate the decoded byte-size of base64 data without allocating buffers
+ */
+function estimateBase64Size(base64Data) {
+    const sanitized = base64Data.replace(/\s+/g, "");
+    const padding = sanitized.endsWith("==") ? 2 : sanitized.endsWith("=") ? 1 : 0;
+    return Math.max(0, (sanitized.length * 3) / 4 - padding);
+}

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;AAIzD;;;;;;;;;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,CAwBhM"}
+{"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"}

package/dist/shared/image-processing.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.downloadImages = downloadImages;
 const config_1 = require("./config");
+const data_uri_1 = require("./data-uri");
 const buffer_1 = require("buffer");
 /**
  * Downloads images from image_metadata blocks and applies smart size/count limiting
@@ -27,11 +28,12 @@ async function downloadImages(content, maxImages = config_1.CONFIG.maxImages, ma
     // Download images in parallel and replace image_metadata blocks
     const downloadPromises = countLimitedContent.map(async (block) => {
         if (block.type === "image_metadata") {
+            if (block.inlineData) {
+                return convertInlineImage(block, perImageBudget);
+            }
             return await downloadSingleImage(block, perImageBudget);
         }
-        else {
-            return block;
-        }
+        return block;
     });
     return Promise.all(downloadPromises);
 }
@@ -68,10 +70,7 @@ function applyCountBasedLimitToImageMetadata(content, maxImages) {
  * Download a single image from an image_metadata block, trying different sizes if needed
  */
 async function downloadSingleImage(imageMetadata, perImageBudget) {
-    const fallbackText = {
-        type: "text",
-        text: `[Image "${imageMetadata.alt}" removed due to size limitations.]`,
-    };
+    const fallbackText = createImageFallback(imageMetadata);
     // Try each URL in order (largest to smallest)
     for (const url of imageMetadata.urls) {
         const abortController = new AbortController();
@@ -124,3 +123,31 @@ async function downloadSingleImage(imageMetadata, perImageBudget) {
     // If all URLs failed or were too large, return fallback text
     return fallbackText;
 }
+/**
+ * Create a fallback text block when an image cannot be included
+ */
+function createImageFallback(imageMetadata) {
+    return {
+        type: "text",
+        text: `[Image "${imageMetadata.alt}" removed due to size limitations.]`,
+    };
+}
+/**
+ * Convert inline image data URIs into image blocks while respecting size budgets
+ */
+function convertInlineImage(imageMetadata, perImageBudget) {
+    const inlineData = imageMetadata.inlineData;
+    if (!inlineData) {
+        return createImageFallback(imageMetadata);
+    }
+    const estimatedSize = (0, data_uri_1.estimateBase64Size)(inlineData.base64Data);
+    if (perImageBudget <= 0 || estimatedSize > perImageBudget) {
+        console.error(`Inline image for "${imageMetadata.alt}" is ${estimatedSize} bytes, exceeds budget of ${perImageBudget} bytes`);
+        return createImageFallback(imageMetadata);
+    }
+    return {
+        type: "image",
+        mimeType: inlineData.mimeType || "image/png",
+        data: inlineData.base64Data,
+    };
+}

package/dist/shared/types.d.ts

@@ -1,9 +1,11 @@
 import { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { ParsedDataUri } from "./data-uri";
 export type ContentBlock = CallToolResult['content'][number];
 export interface ImageMetadataBlock {
     type: "image_metadata";
     urls: string[];
     alt: string;
+    inlineData?: ParsedDataUri;
 }
 export interface DatedContentEvent {
     date: string;

package/dist/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAGD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE,CAAC;CACtD;AAGD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAGD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE,CAAC;CACtD;AAGD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC"}

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;AAapE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAwXtE"}
+{"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;AAapE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QA2YtE"}

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

@@ -81,7 +81,7 @@ function registerTaskToolsWrite(server, userData) {
     });
     server.tool("updateTask", (() => {
         const descriptionBase = [
-            "Updates various aspects of an existing task.",
+            "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.",
@@ -106,10 +106,13 @@ function registerTaskToolsWrite(server, userData) {
         time_estimate: taskTimeEstimateSchema,
         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(createAssigneeDescription(userData)),
+        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)")
     }, {
         readOnlyHint: false
-    }, async ({ task_id, name, append_description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees }) => {
+    }, async ({ task_id, name, append_description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees, blocking, waiting_on, linked_tasks }) => {
         try {
             const userData = await (0, utils_1.getCurrentUser)();
             // Get task details including current markdown description
@@ -120,6 +123,12 @@ function registerTaskToolsWrite(server, userData) {
                 throw new Error(`Error fetching task: ${taskResponse.status} ${taskResponse.statusText}`);
             }
             const taskData = await taskResponse.json();
+            // Handle dependencies separately since they need individual API calls
+            let dependencyUpdateResults = [];
+            if (blocking !== undefined || waiting_on !== undefined || linked_tasks !== undefined) {
+                const dependencyResults = await updateTaskDependencies(task_id, taskData, { blocking, waiting_on, linked_tasks });
+                dependencyUpdateResults = dependencyResults;
+            }
             // Handle tags separately since they need individual API calls
             let tagUpdateResults = [];
             if (tags !== undefined) {
@@ -182,8 +191,8 @@ function registerTaskToolsWrite(server, userData) {
             if (assignees !== undefined) {
                 updateBody.assignees = { add: assignees, rem: [] }; // Add new assignees, remove none
             }
-            // Check if there's anything to update (including tags which were handled separately)
-            if (Object.keys(updateBody).length === 0 && tags === undefined) {
+            // 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) {
                 return {
                     content: [
                         {
@@ -210,8 +219,8 @@ function registerTaskToolsWrite(server, userData) {
                 }
                 updatedTask = await updateResponse.json();
             }
-            // If only tags were updated, fetch the task again to get the updated state
-            if (tags !== undefined && Object.keys(updateBody).length === 0) {
+            // If only tags or dependencies were updated, fetch the task again to get the updated state
+            if ((tags !== undefined || blocking !== undefined || waiting_on !== undefined || linked_tasks !== undefined) && Object.keys(updateBody).length === 0) {
                 const refreshResponse = await fetch(`https://api.clickup.com/api/v2/task/${task_id}`, {
                     headers: { Authorization: config_1.CONFIG.apiKey },
                 });
@@ -220,8 +229,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
+                name, append_description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees, blocking, waiting_on, linked_tasks
             }, userData);
+            // Add dependency update results if any
+            if (dependencyUpdateResults.length > 0) {
+                responseLines.push('dependency_warnings: ' + dependencyUpdateResults.join('; '));
+            }
             // Add tag update results if any
             if (tagUpdateResults.length > 0) {
                 responseLines.push('tag_warnings: ' + tagUpdateResults.join('; '));
@@ -400,6 +413,102 @@ function buildTaskRequestBody(params, currentUserId) {
     }
     return requestBody;
 }
+// Helper function to manage task dependencies
+async function updateTaskDependencies(taskId, taskData, dependencies) {
+    const errors = [];
+    // Get current dependencies
+    const currentBlocking = taskData.blocking?.map((dep) => dep.id) || [];
+    const currentWaitingOn = taskData.waiting_on?.map((dep) => dep.id) || [];
+    const currentLinked = taskData.linked_tasks?.map((task) => task.id) || [];
+    // Helper function to make dependency API calls
+    async function modifyDependency(operation, type, fromTaskId, toTaskId, dependsOn) {
+        try {
+            let url;
+            let options;
+            if (type === 'linked') {
+                // Linked tasks use a different endpoint
+                url = `https://api.clickup.com/api/v2/task/${fromTaskId}/link/${toTaskId}`;
+                options = {
+                    method: operation === 'add' ? 'POST' : 'DELETE',
+                    headers: { Authorization: config_1.CONFIG.apiKey }
+                };
+            }
+            else {
+                // Dependencies (blocking/waiting_on)
+                if (operation === 'add') {
+                    url = `https://api.clickup.com/api/v2/task/${fromTaskId}/dependency`;
+                    options = {
+                        method: 'POST',
+                        headers: {
+                            Authorization: config_1.CONFIG.apiKey,
+                            'Content-Type': 'application/json'
+                        },
+                        body: JSON.stringify({
+                            depends_on: dependsOn,
+                            dependency_type: 1 // Always use 1 for waiting_on type
+                        })
+                    };
+                }
+                else {
+                    // Remove dependency
+                    url = `https://api.clickup.com/api/v2/task/${fromTaskId}/dependency?depends_on=${dependsOn}`;
+                    options = {
+                        method: 'DELETE',
+                        headers: { Authorization: config_1.CONFIG.apiKey }
+                    };
+                }
+            }
+            const response = await fetch(url, options);
+            if (!response.ok) {
+                const action = operation === 'add' ? 'add' : 'remove';
+                const typeLabel = type === 'linked' ? 'link' : type.replace('_', ' ');
+                console.error(`Failed to ${action} ${typeLabel} "${toTaskId}": ${response.status}`);
+                errors.push(`Failed to ${action} ${typeLabel}: ${toTaskId}`);
+            }
+        }
+        catch (error) {
+            const action = operation === 'add' ? 'adding' : 'removing';
+            const typeLabel = type === 'linked' ? 'link' : type.replace('_', ' ');
+            console.error(`Error ${action} ${typeLabel} "${toTaskId}":`, error);
+            errors.push(`Error ${action} ${typeLabel}: ${toTaskId}`);
+        }
+    }
+    // Process blocking dependencies (tasks that should depend on this task)
+    if (dependencies.blocking !== undefined) {
+        const toAdd = dependencies.blocking.filter(id => !currentBlocking.includes(id));
+        const toRemove = currentBlocking.filter((id) => !dependencies.blocking.includes(id));
+        // To make another task depend on this one, add dependency FROM that task TO this task
+        for (const depTaskId of toAdd) {
+            await modifyDependency('add', 'blocking', depTaskId, depTaskId, taskId);
+        }
+        for (const depTaskId of toRemove) {
+            await modifyDependency('remove', 'blocking', depTaskId, depTaskId, taskId);
+        }
+    }
+    // Process waiting_on dependencies
+    if (dependencies.waiting_on !== undefined) {
+        const toAdd = dependencies.waiting_on.filter(id => !currentWaitingOn.includes(id));
+        const toRemove = currentWaitingOn.filter((id) => !dependencies.waiting_on.includes(id));
+        for (const depTaskId of toAdd) {
+            await modifyDependency('add', 'waiting_on', taskId, depTaskId, depTaskId);
+        }
+        for (const depTaskId of toRemove) {
+            await modifyDependency('remove', 'waiting_on', taskId, depTaskId, depTaskId);
+        }
+    }
+    // Process linked tasks
+    if (dependencies.linked_tasks !== undefined) {
+        const toAdd = dependencies.linked_tasks.filter(id => !currentLinked.includes(id));
+        const toRemove = currentLinked.filter((id) => !dependencies.linked_tasks.includes(id));
+        for (const linkedTaskId of toAdd) {
+            await modifyDependency('add', 'linked', taskId, linkedTaskId, linkedTaskId);
+        }
+        for (const linkedTaskId of toRemove) {
+            await modifyDependency('remove', 'linked', taskId, linkedTaskId, linkedTaskId);
+        }
+    }
+    return errors;
+}
 function formatTaskResponse(task, operation, params, userData) {
     const responseLines = [
         `Task ${operation} successfully!`,
@@ -434,5 +543,14 @@ function formatTaskResponse(task, operation, params, userData) {
     if (params.parent_task_id !== undefined) {
         responseLines.push(`parent_task_id: ${params.parent_task_id}`);
     }
+    if (params.blocking !== undefined && params.blocking.length > 0) {
+        responseLines.push(`blocking: ${params.blocking.join(', ')}`);
+    }
+    if (params.waiting_on !== undefined && params.waiting_on.length > 0) {
+        responseLines.push(`waiting_on: ${params.waiting_on.join(', ')}`);
+    }
+    if (params.linked_tasks !== undefined && params.linked_tasks.length > 0) {
+        responseLines.push(`linked_tasks: ${params.linked_tasks.join(', ')}`);
+    }
     return responseLines;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hauptsache.net/clickup-mcp",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "Search, create, and retrieve tasks, add comments, and track time through natural language commands.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,12 +12,13 @@
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "tsc -w & nodemon dist/index.js",
+    "dev": "npx tsc -w & nodemon dist/index.js",
     "cli": "npx ts-node src/cli.ts",
     "prettier": "prettier --write src/**/*.ts",
     "prepublishOnly": "rm -r dist && npm run build",
     "release": "npm run build && npm publish --access public && git add . && git commit -m \"Release v$(node -p 'require(\"./package.json\").version')\" && git tag -a v$(node -p 'require(\"./package.json\").version') -m \"Release v$(node -p 'require(\"./package.json\").version')\" && git push && git push --tags",
-    "dxt": "npm run build && npx dxt pack"
+    "mcpb": "npm run build && mcpb pack . ClickUp.mcpb",
+    "test": "node --test -r ts-node/register src/**/*.test.ts"
   },
   "keywords": [
     "clickup",
@@ -44,11 +45,14 @@
     "zod": "^3.24.2"
   },
   "devDependencies": {
+    "@anthropic-ai/mcpb": "^1.1.1",
     "@types/node": "^22.14.1",
     "dotenv": "^16.5.0",
     "nodemon": "^3.1.9",
     "prettier": "^3.5.3",
-    "typescript": "^5.8.3"
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3",
+    "undici": "^7.16.0"
   },
   "engines": {
     "node": ">=16.0.0"