@hauptsache.net/clickup-mcp 1.2.0 → 1.3.1

package/dist/tools/space-tools.js

@@ -16,6 +16,8 @@ function registerSpaceTools(server) {
             .optional()
             .describe("Array of search terms to match against space names or IDs. If not provided, returns all spaces."),
         archived: zod_1.z.boolean().optional().describe("Include archived spaces (default: false)")
+    }, {
+        readOnlyHint: true
     }, async ({ terms, archived = false }) => {
         try {
             const searchIndex = await (0, utils_1.getSpaceSearchIndex)();
@@ -30,36 +32,10 @@ function registerSpaceTools(server) {
                 matchingSpaces = searchIndex._docs || [];
             }
             else {
-                // Search with fuzzy matching
-                const uniqueResults = new Map();
-                terms.forEach(term => {
-                    const trimmedTerm = term.trim();
-                    if (trimmedTerm.length === 0)
-                        return;
-                    // Check if it's an exact space ID first
-                    const exactMatch = searchIndex._docs.find((space) => space.id === trimmedTerm);
-                    if (exactMatch) {
-                        uniqueResults.set(exactMatch.id, { item: exactMatch, score: 0 });
-                        return;
-                    }
-                    // Fuzzy search
-                    const results = searchIndex.search(trimmedTerm);
-                    results.forEach(result => {
-                        if (result.item && typeof result.item.id === 'string') {
-                            const currentScore = result.score ?? 1;
-                            const existing = uniqueResults.get(result.item.id);
-                            if (!existing || currentScore < existing.score) {
-                                uniqueResults.set(result.item.id, {
-                                    item: result.item,
-                                    score: currentScore
-                                });
-                            }
-                        }
-                    });
-                });
-                matchingSpaces = Array.from(uniqueResults.values())
-                    .sort((a, b) => a.score - b.score)
-                    .map(entry => entry.item);
+                // Perform multi-term search with aggressive boosting
+                matchingSpaces = await (0, utils_1.performMultiTermSearch)(searchIndex, terms
+                // No ID matcher or direct fetcher for spaces - they don't have direct API endpoints
+                );
             }
             // Filter by archived status
             if (!archived) {
@@ -75,87 +51,105 @@ function registerSpaceTools(server) {
                 try {
                     if (matchingSpaces.length <= 5) {
                         // Detailed mode: fetch lists and folders for this space
-                        const { lists, folders } = await (0, utils_1.getSpaceContent)(space.id);
-                        return { space, lists, folders };
+                        const { lists, folders, documents } = await (0, utils_1.getSpaceContent)(space.id);
+                        return { space, lists, folders, documents };
                     }
                     else {
                         // Summary mode: just return space without content
-                        return { space, lists: [], folders: [] };
+                        return { space, lists: [], folders: [], documents: [] };
                     }
                 }
                 catch (error) {
                     console.error(`Error fetching content for space ${space.id}:`, error);
-                    return { space, lists: [], folders: [] };
+                    return { space, lists: [], folders: [], documents: [] };
                 }
             });
             const spacesWithContent = await Promise.all(spaceContentPromises);
             const contentBlocks = [];
-            spacesWithContent.forEach(({ space, lists, folders }, index) => {
-                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`);
-                // Create a tree structure
-                const hasDirectLists = lists.length > 0;
-                const hasFolders = folders.length > 0;
-                // Direct lists (not in folders)
-                if (hasDirectLists) {
-                    lists.forEach((list, listIndex) => {
-                        const isLastDirectList = listIndex === lists.length - 1;
-                        const isLastOverall = !hasFolders && 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 folderTreeChar = isLastFolder ? '└──' : '├──';
-                        const folderContinuation = isLastFolder ? '   ' : '│  ';
-                        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);
-                            });
-                        }
+            const isDetailedMode = matchingSpaces.length <= 5;
+            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);
+                        });
+                    }
+                    // Add the complete space as a single content block
+                    contentBlocks.push({
+                        type: "text",
+                        text: spaceLines.join('\n')
                     });
-                }
-                // Add the complete space as a single content block
+                });
+            }
+            else {
+                // Summary mode: create a single combined block with all spaces
+                const allSpaceLines = [];
+                spacesWithContent.forEach(({ space }) => {
+                    allSpaceLines.push(`🏢 SPACE: ${space.name} (space_id: ${space.id}${space.private ? ', private' : ''}${space.archived ? ', archived' : ''})`);
+                });
                 contentBlocks.push({
                     type: "text",
-                    text: spaceLines.join('\n')
+                    text: allSpaceLines.join('\n')
                 });
-                // Add separator between spaces (except for the last one)
-                if (index < spacesWithContent.length - 1) {
-                    contentBlocks.push({
-                        type: "text",
-                        text: '─'.repeat(50)
-                    });
-                }
-            });
-            const totalLists = spacesWithContent.reduce((sum, { lists, folders }) => sum + lists.length + folders.reduce((folderSum, f) => folderSum + (f.lists?.length || 0), 0), 0);
+            }
             // Add tip message for summary mode (when there are too many spaces)
             if (matchingSpaces.length > 5) {
                 contentBlocks.push({
@@ -168,8 +162,12 @@ function registerSpaceTools(server) {
                     {
                         type: "text",
                         text: matchingSpaces.length <= 5
-                            ? `Found ${matchingSpaces.length} space(s) with complete tree structure (${totalLists} total lists):`
-                            : `Found ${matchingSpaces.length} space(s) - too many to show detailed list information. Please search more precisely to get complete tree structure with lists and folders:`
+                            ? (() => {
+                                const totalLists = spacesWithContent.reduce((sum, { lists, folders }) => sum + lists.length + folders.reduce((folderSum, f) => folderSum + (f.lists?.length || 0), 0), 0);
+                                const totalDocuments = spacesWithContent.reduce((sum, { documents }) => sum + documents.length, 0);
+                                return `Found ${matchingSpaces.length} space(s) with complete tree structure (${totalLists} total lists, ${totalDocuments} total documents):`;
+                            })()
+                            : `Found ${matchingSpaces.length} space(s) - showing names and IDs only. Use more specific search terms to get detailed information:`
                     },
                     ...contentBlocks
                 ],

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

package/dist/tools/task-tools.js

@@ -22,6 +22,8 @@ function registerTaskToolsRead(server, userData) {
             message: "Task ID must be 6-9 alphanumeric characters only"
         })
             .describe(`The 6-9 character ID of the task to get without a prefix like "#", "CU-" or "https://app.clickup.com/t/"`),
+    }, {
+        readOnlyHint: true
     }, async ({ id }) => {
         // 1. Load base task content, comment events, and status change events in parallel
         const [taskDetailContentBlocks, commentEvents, statusChangeEvents] = await Promise.all([
@@ -91,7 +93,7 @@ async function loadTaskContent(taskId) {
             return await generateTaskMetadata(task, timeEntries, true);
         })(),
         // process markdown and download images
-        (0, clickup_text_1.processClickUpMarkdown)(task.markdown_description || "", task.attachments),
+        (0, clickup_text_1.processClickUpMarkdown)(task.markdown_description || "", task.attachments || []),
     ]);
     return [taskMetadata, ...content];
 }

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

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

@@ -30,6 +30,8 @@ function registerTaskToolsWrite(server, userData) {
     })(), {
         task_id: zod_1.z.string().min(6).max(9).describe("The 6-9 character task ID to comment on"),
         comment: zod_1.z.string().min(1).describe("The comment text to add to the task"),
+    }, {
+        readOnlyHint: false
     }, async ({ task_id, comment }) => {
         try {
             const requestBody = {
@@ -105,6 +107,8 @@ function registerTaskToolsWrite(server, userData) {
         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))
+    }, {
+        readOnlyHint: false
     }, async ({ task_id, name, append_description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees }) => {
         try {
             const userData = await (0, utils_1.getCurrentUser)();
@@ -213,6 +217,8 @@ function registerTaskToolsWrite(server, userData) {
         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))
+    }, {
+        readOnlyHint: false
     }, async ({ list_id, name, description, status, priority, due_date, start_date, time_estimate, tags, parent_task_id, assignees }) => {
         try {
             const userData = await (0, utils_1.getCurrentUser)();

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;AA0DpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA6EtD;AAwLD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAmFvD"}
+{"version":3,"file":"time-tools.d.ts","sourceRoot":"","sources":["../../src/tools/time-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0DpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAgFtD;AAwLD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAsFvD"}

package/dist/tools/time-tools.js

@@ -58,6 +58,8 @@ function registerTimeToolsRead(server) {
         list_id: zod_1.z.string().optional().describe("Optional single list ID to filter time entries by a specific list"),
         space_id: zod_1.z.string().optional().describe("Optional single space ID to filter time entries by a specific space"),
         include_all_users: zod_1.z.boolean().optional().describe("Optional flag to include time entries from all team members (default: false, only current user)")
+    }, {
+        readOnlyHint: true
     }, async ({ task_id, start_date, end_date, list_id, space_id, include_all_users }) => {
         try {
             // Build query parameters
@@ -268,6 +270,8 @@ function registerTimeToolsWrite(server) {
         hours: zod_1.z.number().min(0.01).max(24).describe("Hours to book (decimal format, e.g., 0.25 = 15min, 1.5 = 1h 30min)"),
         description: zod_1.z.string().optional().describe("Optional description for the time entry"),
         start_time: zod_1.z.string().optional().describe("Optional start time as ISO date string (e.g., '2024-10-06T09:00:00+02:00', defaults to current time)")
+    }, {
+        readOnlyHint: false
     }, async ({ task_id, hours, description, start_time }) => {
         try {
             // Convert hours to milliseconds (ClickUp API uses milliseconds)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hauptsache.net/clickup-mcp",
-  "version": "1.2.0",
-  "description": "Transform your AI assistant into a powerful ClickUp integration for both agentic coding and productivity management. Enables seamless task context sharing, intelligent search, time tracking, and complete project management workflows.",
+  "version": "1.3.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",
   "bin": "dist/index.js",
@@ -36,9 +36,9 @@
     "name": "Marco Pfeiffer",
     "email": "marco@hauptsache.net"
   },
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.9.0",
+    "@modelcontextprotocol/sdk": "^1.15.1",
     "fuse.js": "^7.1.0",
     "zod": "^3.24.2"
   },