@hauptsache.net/clickup-mcp 1.3.2 → 1.4.1

package/dist/cli.js

@@ -13,9 +13,81 @@ async function main() {
         console.log(server.server._instructions || "No instructions configured");
         process.exit(0);
     }
+    // Special commands for testing resources
+    if (args.length === 1 && args[0] === 'resources') {
+        console.log("Listing available resources...");
+        try {
+            // @ts-ignore - Accessing private property for testing purposes
+            const resourceTemplates = server._registeredResourceTemplates;
+            if (resourceTemplates && Object.keys(resourceTemplates).length > 0) {
+                for (const [name, template] of Object.entries(resourceTemplates)) {
+                    console.log(`Resource template: ${name}`);
+                    // @ts-ignore - Access template properties
+                    const uriTemplate = template.resourceTemplate.uriTemplate;
+                    console.log(`  URI Template: ${uriTemplate}`);
+                    // Test the list callback if available
+                    // @ts-ignore - Access template properties
+                    if (template.resourceTemplate._callbacks.list) {
+                        try {
+                            // @ts-ignore - Call list callback
+                            const result = await template.resourceTemplate._callbacks.list();
+                            console.log(`  Resources found: ${result.resources.length}`);
+                            result.resources.slice(0, 3).forEach((res, idx) => {
+                                console.log(`    ${idx + 1}. ${res.name} (${res.uri})`);
+                            });
+                            if (result.resources.length > 3) {
+                                console.log(`    ... and ${result.resources.length - 3} more`);
+                            }
+                        }
+                        catch (error) {
+                            console.log(`  Error listing resources: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                        }
+                    }
+                    console.log("");
+                }
+            }
+            else {
+                console.log("No resource templates registered.");
+            }
+        }
+        catch (error) {
+            console.error("Error accessing resources:", error instanceof Error ? error.message : 'Unknown error');
+        }
+        process.exit(0);
+    }
+    // Special command to read a specific resource
+    if (args.length === 2 && args[0] === 'resource') {
+        const resourceUri = args[1];
+        console.log(`Reading resource: ${resourceUri}`);
+        try {
+            // @ts-ignore - Accessing private property for testing purposes
+            const resourceTemplates = server._registeredResourceTemplates;
+            // Find matching template and call read callback
+            for (const [name, template] of Object.entries(resourceTemplates)) {
+                try {
+                    // @ts-ignore - Access template properties
+                    const result = await template.readCallback(new URL(resourceUri), {}, {});
+                    console.dir(result, { depth: null });
+                    process.exit(0);
+                }
+                catch (error) {
+                    // Continue to next template if this one doesn't match
+                    continue;
+                }
+            }
+            console.error("No matching resource template found for URI:", resourceUri);
+            process.exit(1);
+        }
+        catch (error) {
+            console.error("Error reading resource:", error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+    }
     if (args.length < 1) {
         console.error("Usage: npm run cli <tool-name> [param1=value1 param2=value2 ...]");
         console.error("       npm run cli instructions");
+        console.error("       npm run cli resources");
+        console.error("       npm run cli resource <uri>");
         console.error("\nAvailable tools:");
         // @ts-ignore - Accessing private property for testing purposes
         const tools = server._registeredTools;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiIpE,QAAA,MAAM,aAAa,oBAAqB,CAAC;AAIzC,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqIpE,QAAA,MAAM,aAAa,oBAAqB,CAAC;AAIzC,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -14,6 +14,7 @@ const space_tools_1 = require("./tools/space-tools");
 const list_tools_1 = require("./tools/list-tools");
 const time_tools_1 = require("./tools/time-tools");
 const doc_tools_1 = require("./tools/doc-tools");
+const space_resources_1 = require("./resources/space-resources");
 // Create server variable that will be initialized later
 let server;
 // Register tools based on mode with user data for enhanced documentation
@@ -97,6 +98,7 @@ Use the ClickUp search tools to find tasks assigned to me, and get detailed info
         (0, task_tools_1.registerTaskToolsRead)(server, userData);
         (0, search_tools_1.registerSearchTools)(server, userData);
         (0, space_tools_1.registerSpaceTools)(server);
+        (0, space_resources_1.registerSpaceResources)(server);
         (0, list_tools_1.registerListToolsRead)(server);
         (0, time_tools_1.registerTimeToolsRead)(server);
         (0, doc_tools_1.registerDocumentToolsRead)(server);
@@ -107,6 +109,7 @@ Use the ClickUp search tools to find tasks assigned to me, and get detailed info
         (0, task_write_tools_1.registerTaskToolsWrite)(server, userData);
         (0, search_tools_1.registerSearchTools)(server, userData);
         (0, space_tools_1.registerSpaceTools)(server);
+        (0, space_resources_1.registerSpaceResources)(server);
         (0, list_tools_1.registerListToolsRead)(server);
         (0, list_tools_1.registerListToolsWrite)(server);
         (0, time_tools_1.registerTimeToolsRead)(server);
@@ -120,7 +123,9 @@ Use the ClickUp search tools to find tasks assigned to me, and get detailed info
 const serverPromise = initializeServer();
 exports.serverPromise = serverPromise;
 // Only connect to the transport if this file is being run directly (not imported)
-if (require.main === module) {
+// OR if not being imported by CLI (to support Claude Desktop's module loading)
+const isCliMode = process.argv.some(arg => arg.includes('cli.ts') || arg.includes('cli.js'));
+if (require.main === module || !isCliMode) {
     // Start receiving messages on stdin and sending messages on stdout after initialization
     serverPromise.then(() => {
         const transport = new stdio_js_1.StdioServerTransport();

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

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register ClickUp space resources using resource templates for dynamic discovery
+ */
+export declare function registerSpaceResources(server: McpServer): void;
+//# sourceMappingURL=space-resources.d.ts.map

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

@@ -0,0 +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"}

package/dist/resources/space-resources.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSpaceResources = registerSpaceResources;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const utils_1 = require("../shared/utils");
+/**
+ * Extract space ID from clickup:// URI
+ */
+function extractSpaceIdFromUri(uriString) {
+    try {
+        const url = new URL(uriString);
+        const pathParts = url.pathname.split('/');
+        return pathParts[pathParts.length - 1];
+    }
+    catch (error) {
+        throw new Error(`Invalid ClickUp space URI: ${uriString}`);
+    }
+}
+/**
+ * Register ClickUp space resources using resource templates for dynamic discovery
+ */
+function registerSpaceResources(server) {
+    // Create resource template for ClickUp spaces
+    const spaceTemplate = new mcp_js_1.ResourceTemplate("clickup://space/{spaceId}", {
+        list: async () => {
+            try {
+                const searchIndex = await (0, utils_1.getSpaceSearchIndex)();
+                if (!searchIndex) {
+                    return { resources: [] };
+                }
+                const spaces = searchIndex._docs || [];
+                // Filter out archived spaces for resource listing
+                const activeSpaces = spaces.filter((space) => !space.archived);
+                return {
+                    resources: activeSpaces.map((space) => ({
+                        uri: `clickup://space/${space.id}`,
+                        name: space.name,
+                        mimeType: "text/plain"
+                    }))
+                };
+            }
+            catch (error) {
+                console.error("Error listing space resources:", error);
+                return { resources: [] };
+            }
+        }
+    });
+    // Register resource template for ClickUp spaces
+    server.registerResource("clickup-spaces", spaceTemplate, {
+        title: "ClickUp Spaces",
+        description: "Access ClickUp spaces with their complete structure including lists, folders, and documents",
+    }, async (uri) => {
+        try {
+            const spaceId = extractSpaceIdFromUri(uri.toString());
+            // Fetch space content including lists, folders, and documents
+            const { lists, folders, documents } = await (0, utils_1.getSpaceContent)(spaceId);
+            // Get space details from the search index
+            const searchIndex = await (0, utils_1.getSpaceSearchIndex)();
+            const spaces = searchIndex._docs || [];
+            const space = spaces.find((s) => s.id === spaceId);
+            if (!space) {
+                return {
+                    contents: [{
+                            uri: uri.toString(),
+                            text: `Space with ID ${spaceId} not found.`,
+                        }]
+                };
+            }
+            // Format the content using the shared tree formatting function
+            const treeContent = (0, utils_1.formatSpaceTree)(space, lists, folders, documents);
+            // Add resource metadata
+            const metadata = [
+                '\n---',
+                `ℹ️ Resource last updated: ${new Date().toISOString()}`,
+                `💡 For real-time data, use the searchSpaces tool`
+            ].join('\n');
+            return {
+                contents: [{
+                        uri: uri.toString(),
+                        text: treeContent + metadata,
+                    }]
+            };
+        }
+        catch (error) {
+            console.error("Error reading space resource:", error);
+            return {
+                contents: [{
+                        uri: uri.toString(),
+                        text: `Error reading space: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }]
+            };
+        }
+    });
+}

package/dist/shared/utils.d.ts

@@ -39,6 +39,11 @@ export declare function generateFolderUrl(folderId: string): string;
  * Generate a ClickUp document URL from a document ID and optional page ID
  */
 export declare function generateDocumentUrl(docId: string, pageId?: string): string;
+/**
+ * Format space content as tree structure
+ * Shared function used by both searchSpaces tool and space resources
+ */
+export declare function formatSpaceTree(space: any, lists: any[], folders: any[], documents: any[]): string;
 /**
  * Get or refresh the space search index
  * Caches promise to prevent race conditions on concurrent calls

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,SAAS,CAAC;AAI3B;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG7C;AAKD;;;GAGG;AACH,wBAAsB,cAAc,iBA6BnC;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CA0B7D;AAKD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA+B3B;AAkED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAKD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA+CrE;AAKD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,SAAS,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,CAgFlH;AAKD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA+C3D;AAKD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA6B3B;AAuID;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,CAAC,EAAE,CAAC,CA8Dd"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,SAAS,CAAC;AAI3B;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG7C;AAKD;;;GAGG;AACH,wBAAsB,cAAc,iBA6BnC;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CA0B7D;AAKD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA+B3B;AAkED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,CA4ElG;AAKD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA+CrE;AAKD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,SAAS,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,CAgFlH;AAKD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA+C3D;AAKD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CA6B3B;AAuID;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,CAAC,EAAE,CAAC,CA8Dd"}

package/dist/shared/utils.js

@@ -13,6 +13,7 @@ exports.generateListUrl = generateListUrl;
 exports.generateSpaceUrl = generateSpaceUrl;
 exports.generateFolderUrl = generateFolderUrl;
 exports.generateDocumentUrl = generateDocumentUrl;
+exports.formatSpaceTree = formatSpaceTree;
 exports.getSpaceSearchIndex = getSpaceSearchIndex;
 exports.getSpaceContent = getSpaceContent;
 exports.getAllTeamMembers = getAllTeamMembers;
@@ -209,6 +210,75 @@ function generateDocumentUrl(docId, pageId) {
     }
     return `https://app.clickup.com/${config_1.CONFIG.teamId}/v/dc/${docId}`;
 }
+/**
+ * Format space content as tree structure
+ * Shared function used by both searchSpaces tool and space resources
+ */
+function formatSpaceTree(space, lists, folders, documents) {
+    const spaceLines = [];
+    const totalLists = lists.length + folders.reduce((sum, f) => sum + (f.lists?.length || 0), 0);
+    // Space header
+    spaceLines.push(`🏢 SPACE: ${space.name} (space_id: ${space.id}${space.private ? ', private' : ''}${space.archived ? ', archived' : ''}) ${generateSpaceUrl(space.id)}`, `   ${totalLists} lists, ${folders.length} folders, ${documents.length} documents`);
+    // Create a tree structure
+    const hasDirectLists = lists.length > 0;
+    const hasFolders = folders.length > 0;
+    const hasDocuments = documents.length > 0;
+    // Direct lists (not in folders)
+    if (hasDirectLists) {
+        lists.forEach((list, listIndex) => {
+            const isLastDirectList = listIndex === lists.length - 1;
+            const isLastOverall = !hasFolders && !hasDocuments && isLastDirectList;
+            const treeChar = isLastOverall ? '└──' : '├──';
+            const extraInfo = [
+                ...(list.task_count ? [`${list.task_count} tasks`] : []),
+                ...(list.private ? ['private'] : []),
+                ...(list.archived ? ['archived'] : [])
+            ].join(', ');
+            const listLine = `${treeChar} 📝 ${list.name} (list_id: ${list.id}${extraInfo ? `, ${extraInfo}` : ''}) ${generateListUrl(list.id)}`;
+            spaceLines.push(listLine);
+        });
+    }
+    // Folders and their lists
+    if (hasFolders) {
+        folders.forEach((folder, folderIndex) => {
+            const isLastFolder = folderIndex === folders.length - 1;
+            const isLastOverall = !hasDocuments && isLastFolder;
+            const folderTreeChar = isLastOverall ? '└──' : '├──';
+            const folderContinuation = isLastOverall ? '   ' : '│  ';
+            const folderExtraInfo = [
+                ...(folder.lists?.length ? [`${folder.lists.length} lists`] : []),
+                ...(folder.private ? ['private'] : []),
+                ...(folder.archived ? ['archived'] : [])
+            ].join(', ');
+            const folderLine = `${folderTreeChar} 📂 ${folder.name} (folder_id: ${folder.id}${folderExtraInfo ? `, ${folderExtraInfo}` : ''}) ${generateFolderUrl(folder.id)}`;
+            spaceLines.push(folderLine);
+            // Lists within this folder
+            if (folder.lists && folder.lists.length > 0) {
+                folder.lists.forEach((list, listIndex) => {
+                    const isLastListInFolder = listIndex === folder.lists.length - 1;
+                    const listTreeChar = isLastListInFolder ? '└──' : '├──';
+                    const listExtraInfo = [
+                        ...(list.task_count ? [`${list.task_count} tasks`] : []),
+                        ...(list.private ? ['private'] : []),
+                        ...(list.archived ? ['archived'] : [])
+                    ].join(', ');
+                    const listLine = `${folderContinuation}${listTreeChar} 📝 ${list.name} (list_id: ${list.id}${listExtraInfo ? `, ${listExtraInfo}` : ''}) ${generateListUrl(list.id)}`;
+                    spaceLines.push(listLine);
+                });
+            }
+        });
+    }
+    // Documents attached to this space
+    if (hasDocuments) {
+        documents.forEach((document, docIndex) => {
+            const isLastDocument = docIndex === documents.length - 1;
+            const docTreeChar = isLastDocument ? '└──' : '├──';
+            const docLine = `${docTreeChar} 📄 ${document.name} (doc_id: ${document.id}) ${generateDocumentUrl(document.id)}`;
+            spaceLines.push(docLine);
+        });
+    }
+    return spaceLines.join('\n');
+}
 // Space search index cache - cache promise to prevent race conditions
 let spaceSearchIndexPromise = null;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"space-tools.d.ts","sourceRoot":"","sources":["../../src/tools/space-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAoNnD"}
+{"version":3,"file":"space-tools.d.ts","sourceRoot":"","sources":["../../src/tools/space-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA6InD"}

package/dist/tools/space-tools.js

@@ -70,72 +70,12 @@ function registerSpaceTools(server) {
             if (isDetailedMode) {
                 // Detailed mode: create separate blocks for each space
                 spacesWithContent.forEach(({ space, lists, folders, documents }) => {
-                    const spaceLines = [];
-                    const totalLists = lists.length + folders.reduce((sum, f) => sum + (f.lists?.length || 0), 0);
-                    // Space header
-                    spaceLines.push(`🏢 SPACE: ${space.name} (space_id: ${space.id}${space.private ? ', private' : ''}${space.archived ? ', archived' : ''}) ${(0, utils_1.generateSpaceUrl)(space.id)}`, `   ${totalLists} lists, ${folders.length} folders, ${documents.length} documents`);
-                    // Create a tree structure
-                    const hasDirectLists = lists.length > 0;
-                    const hasFolders = folders.length > 0;
-                    const hasDocuments = documents.length > 0;
-                    // Direct lists (not in folders)
-                    if (hasDirectLists) {
-                        lists.forEach((list, listIndex) => {
-                            const isLastDirectList = listIndex === lists.length - 1;
-                            const isLastOverall = !hasFolders && !hasDocuments && isLastDirectList;
-                            const treeChar = isLastOverall ? '└──' : '├──';
-                            const extraInfo = [
-                                ...(list.task_count ? [`${list.task_count} tasks`] : []),
-                                ...(list.private ? ['private'] : []),
-                                ...(list.archived ? ['archived'] : [])
-                            ].join(', ');
-                            const listLine = `${treeChar} 📝 ${list.name} (list_id: ${list.id}${extraInfo ? `, ${extraInfo}` : ''}) ${(0, utils_1.generateListUrl)(list.id)}`;
-                            spaceLines.push(listLine);
-                        });
-                    }
-                    // Folders and their lists
-                    if (hasFolders) {
-                        folders.forEach((folder, folderIndex) => {
-                            const isLastFolder = folderIndex === folders.length - 1;
-                            const isLastOverall = !hasDocuments && isLastFolder;
-                            const folderTreeChar = isLastOverall ? '└──' : '├──';
-                            const folderContinuation = isLastOverall ? '   ' : '│  ';
-                            const folderExtraInfo = [
-                                ...(folder.lists?.length ? [`${folder.lists.length} lists`] : []),
-                                ...(folder.private ? ['private'] : []),
-                                ...(folder.archived ? ['archived'] : [])
-                            ].join(', ');
-                            const folderLine = `${folderTreeChar} 📂 ${folder.name} (folder_id: ${folder.id}${folderExtraInfo ? `, ${folderExtraInfo}` : ''}) ${(0, utils_1.generateFolderUrl)(folder.id)}`;
-                            spaceLines.push(folderLine);
-                            // Lists within this folder
-                            if (folder.lists && folder.lists.length > 0) {
-                                folder.lists.forEach((list, listIndex) => {
-                                    const isLastListInFolder = listIndex === folder.lists.length - 1;
-                                    const listTreeChar = isLastListInFolder ? '└──' : '├──';
-                                    const listExtraInfo = [
-                                        ...(list.task_count ? [`${list.task_count} tasks`] : []),
-                                        ...(list.private ? ['private'] : []),
-                                        ...(list.archived ? ['archived'] : [])
-                                    ].join(', ');
-                                    const listLine = `${folderContinuation}${listTreeChar} 📝 ${list.name} (list_id: ${list.id}${listExtraInfo ? `, ${listExtraInfo}` : ''}) ${(0, utils_1.generateListUrl)(list.id)}`;
-                                    spaceLines.push(listLine);
-                                });
-                            }
-                        });
-                    }
-                    // Documents attached to this space
-                    if (hasDocuments) {
-                        documents.forEach((document, docIndex) => {
-                            const isLastDocument = docIndex === documents.length - 1;
-                            const docTreeChar = isLastDocument ? '└──' : '├──';
-                            const docLine = `${docTreeChar} 📄 ${document.name} (doc_id: ${document.id}) ${(0, utils_1.generateDocumentUrl)(document.id)}`;
-                            spaceLines.push(docLine);
-                        });
-                    }
+                    // Use shared tree formatting function
+                    const spaceTreeText = (0, utils_1.formatSpaceTree)(space, lists, folders, documents);
                     // Add the complete space as a single content block
                     contentBlocks.push({
                         type: "text",
-                        text: spaceLines.join('\n')
+                        text: spaceTreeText
                     });
                 });
             }

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,QAqTtE"}
+{"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"}

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

@@ -120,6 +120,48 @@ function registerTaskToolsWrite(server, userData) {
                 throw new Error(`Error fetching task: ${taskResponse.status} ${taskResponse.statusText}`);
             }
             const taskData = await taskResponse.json();
+            // Handle tags separately since they need individual API calls
+            let tagUpdateResults = [];
+            if (tags !== undefined) {
+                // Get current tags
+                const currentTags = taskData.tags?.map((t) => t.name) || [];
+                const tagsToAdd = tags.filter(tag => !currentTags.includes(tag));
+                const tagsToRemove = currentTags.filter((tag) => !tags.includes(tag));
+                // Add new tags
+                for (const tagName of tagsToAdd) {
+                    try {
+                        const addTagResponse = await fetch(`https://api.clickup.com/api/v2/task/${task_id}/tag/${encodeURIComponent(tagName)}`, {
+                            method: 'POST',
+                            headers: { Authorization: config_1.CONFIG.apiKey }
+                        });
+                        if (!addTagResponse.ok) {
+                            console.error(`Failed to add tag "${tagName}": ${addTagResponse.status}`);
+                            tagUpdateResults.push(`Failed to add tag: ${tagName}`);
+                        }
+                    }
+                    catch (error) {
+                        console.error(`Error adding tag "${tagName}":`, error);
+                        tagUpdateResults.push(`Error adding tag: ${tagName}`);
+                    }
+                }
+                // Remove old tags
+                for (const tagName of tagsToRemove) {
+                    try {
+                        const removeTagResponse = await fetch(`https://api.clickup.com/api/v2/task/${task_id}/tag/${encodeURIComponent(tagName)}`, {
+                            method: 'DELETE',
+                            headers: { Authorization: config_1.CONFIG.apiKey }
+                        });
+                        if (!removeTagResponse.ok) {
+                            console.error(`Failed to remove tag "${tagName}": ${removeTagResponse.status}`);
+                            tagUpdateResults.push(`Failed to remove tag: ${tagName}`);
+                        }
+                    }
+                    catch (error) {
+                        console.error(`Error removing tag "${tagName}":`, error);
+                        tagUpdateResults.push(`Error removing tag: ${tagName}`);
+                    }
+                }
+            }
             // Handle append-only description update with markdown support
             let finalDescription;
             if (append_description) {
@@ -128,9 +170,9 @@ function registerTaskToolsWrite(server, userData) {
                 const separator = currentDescription.trim() ? "\n\n---\n" : "";
                 finalDescription = currentDescription + separator + `**Edit (${timestamp}):** ${append_description}`;
             }
-            // Build update body using shared utility (without description since we handle it separately)
+            // Build update body without tags (they're handled separately)
             const updateBody = buildTaskRequestBody({
-                name, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees
+                name, status, priority, due_date, start_date, time_estimate, parent_task_id, assignees
             });
             // Add markdown description if we have content to append
             if (finalDescription !== undefined) {
@@ -140,8 +182,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
-            if (Object.keys(updateBody).length === 0) {
+            // Check if there's anything to update (including tags which were handled separately)
+            if (Object.keys(updateBody).length === 0 && tags === undefined) {
                 return {
                     content: [
                         {
@@ -151,23 +193,39 @@ function registerTaskToolsWrite(server, userData) {
                     ],
                 };
             }
-            // Update the task
-            const updateResponse = await fetch(`https://api.clickup.com/api/v2/task/${task_id}`, {
-                method: 'PUT',
-                headers: {
-                    Authorization: config_1.CONFIG.apiKey,
-                    'Content-Type': 'application/json'
-                },
-                body: JSON.stringify(updateBody)
-            });
-            if (!updateResponse.ok) {
-                const errorData = await updateResponse.json().catch(() => ({}));
-                throw new Error(`Error updating task: ${updateResponse.status} ${updateResponse.statusText} - ${JSON.stringify(errorData)}`);
+            // Update the task (if there are non-tag updates)
+            let updatedTask = taskData;
+            if (Object.keys(updateBody).length > 0) {
+                const updateResponse = await fetch(`https://api.clickup.com/api/v2/task/${task_id}`, {
+                    method: 'PUT',
+                    headers: {
+                        Authorization: config_1.CONFIG.apiKey,
+                        'Content-Type': 'application/json'
+                    },
+                    body: JSON.stringify(updateBody)
+                });
+                if (!updateResponse.ok) {
+                    const errorData = await updateResponse.json().catch(() => ({}));
+                    throw new Error(`Error updating task: ${updateResponse.status} ${updateResponse.statusText} - ${JSON.stringify(errorData)}`);
+                }
+                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) {
+                const refreshResponse = await fetch(`https://api.clickup.com/api/v2/task/${task_id}`, {
+                    headers: { Authorization: config_1.CONFIG.apiKey },
+                });
+                if (refreshResponse.ok) {
+                    updatedTask = await refreshResponse.json();
+                }
             }
-            const updatedTask = await updateResponse.json();
             const responseLines = formatTaskResponse(updatedTask, 'updated', {
                 name, append_description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees
             }, userData);
+            // Add tag update results if any
+            if (tagUpdateResults.length > 0) {
+                responseLines.push('tag_warnings: ' + tagUpdateResults.join('; '));
+            }
             return {
                 content: [
                     {
@@ -329,9 +387,8 @@ function buildTaskRequestBody(params, currentUserId) {
     if (params.time_estimate !== undefined) {
         requestBody.time_estimate = Math.round(params.time_estimate * 60 * 60 * 1000);
     }
-    if (params.tags !== undefined && params.tags.length > 0) {
-        requestBody.tags = params.tags;
-    }
+    // Tags are handled separately via dedicated API endpoints
+    // Do not include in the update request body
     if (params.assignees !== undefined) {
         requestBody.assignees = params.assignees;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hauptsache.net/clickup-mcp",
-  "version": "1.3.2",
+  "version": "1.4.1",
   "description": "Search, create, and retrieve tasks, add comments, and track time through natural language commands.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,7 +16,8 @@
     "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"
+    "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"
   },
   "keywords": [
     "clickup",