@sebastienheyd/clickup-mcp 1.6.3 → 1.7.0

package/dist/cli.js

@@ -167,7 +167,7 @@ async function main() {
             process.env.CLICKUP_TEAM_ID = process.env.CLICKUP_TEAM_ID || 'test_team_id';
         }
         // Call the tool's callback function
-        const result = await tool.callback(params);
+        const result = await tool.handler(params);
         console.dir(result.content);
         process.exit(0);
     }

package/dist/test-utils.js

@@ -30,7 +30,7 @@ class ToolTester {
             throw new Error(`Parameter validation error: ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
         // Call the tool's callback directly with the provided parameters
-        return await tool.callback(params);
+        return await tool.handler(params);
     }
 }
 exports.ToolTester = ToolTester;

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

@@ -1 +1 @@
-{"version":3,"file":"doc-tools.d.ts","sourceRoot":"","sources":["../../src/tools/doc-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoDpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,QA0J1D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAoS3D"}
+{"version":3,"file":"doc-tools.d.ts","sourceRoot":"","sources":["../../src/tools/doc-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoDpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,QA6J1D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAuS3D"}

package/dist/tools/doc-tools.js

@@ -45,7 +45,9 @@ function displayPageHierarchy(pageGroup, currentPageId, depth = 0) {
     return result;
 }
 function registerDocumentToolsRead(server) {
-    server.tool("readDocument", [
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("readDocument", [
         "Get a ClickUp document with page structure and content.",
         "Documents can be discovered via searchSpaces (which includes documents in space tree) or by direct URL from the user or within tasks.",
         "Always use the document URL when referencing documents in conversations or sharing with others.",
@@ -182,7 +184,9 @@ function registerDocumentToolsRead(server) {
     });
 }
 function registerDocumentToolsWrite(server) {
-    server.tool("updateDocumentPage", [
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("updateDocumentPage", [
         "Updates an existing document page's content and/or name.",
         "Use this when you have both doc_id and page_id from readDocument.",
         "Content is in markdown format and can be replaced or appended.",
@@ -275,7 +279,7 @@ function registerDocumentToolsWrite(server) {
             };
         }
     });
-    server.tool("createDocumentOrPage", [
+    tool("createDocumentOrPage", [
         "Creates a new document with its first page, OR adds a page to an existing document.",
         "To create a NEW document: provide space_id OR list_id + name + content",
         "To add a page to EXISTING document: provide doc_id + name + content",

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

@@ -1 +1 @@
-{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../src/tools/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAkHtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA8EvD"}
+{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../src/tools/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAqHtD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAiFvD"}

package/dist/tools/list-tools.js

@@ -6,7 +6,9 @@ const zod_1 = require("zod");
 const config_1 = require("../shared/config");
 const utils_1 = require("../shared/utils");
 function registerListToolsRead(server) {
-    server.tool("getListInfo", [
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("getListInfo", [
         "Gets comprehensive information about a list including description and available statuses.",
         "ALWAYS use the list URL (https://app.clickup.com/v/l/LIST_ID) when referencing lists.",
         "Use this before creating tasks to understand the list context and available statuses for new tasks.",
@@ -107,7 +109,9 @@ function registerListToolsRead(server) {
     });
 }
 function registerListToolsWrite(server) {
-    server.tool("updateListInfo", [
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("updateListInfo", [
         "Appends documentation or context to a list's description.",
         "ALWAYS reference the list URL (https://app.clickup.com/v/l/LIST_ID) when updating or discussing lists.",
         "SAFETY FEATURE: Description updates are APPEND-ONLY to prevent data loss - existing content is preserved.",

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

@@ -1 +1 @@
-{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../../src/tools/search-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAQlE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAiNnE"}
+{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../../src/tools/search-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAQlE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAoNnE"}

package/dist/tools/search-tools.js

@@ -7,6 +7,8 @@ const utils_1 = require("../shared/utils");
 const task_tools_1 = require("./task-tools");
 const MAX_SEARCH_RESULTS = 50;
 function registerSearchTools(server, userData) {
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
     // Dynamically construct the searchTasks description
     const searchTasksDescriptionBase = [
         "Searches tasks (sometimes called Tickets or Cards) by name, content, assignees, and ID with fuzzy matching and support for multiple search terms (OR logic).",
@@ -19,7 +21,7 @@ function registerSearchTools(server, userData) {
     searchTasksDescriptionBase.push("Always reference tasks by their URLs when discussing search results or suggesting actions.");
     searchTasksDescriptionBase.push("You'll get a rough overview of the tasks that match the search terms, sorted by relevance.");
     searchTasksDescriptionBase.push("Always use getTaskById to get more specific information if a task is relevant, and always share the task URL.");
-    server.tool("searchTasks", searchTasksDescriptionBase.join("\n"), {
+    tool("searchTasks", searchTasksDescriptionBase.join("\n"), {
         terms: zod_1.z
             .array(zod_1.z.string())
             .optional()
@@ -65,7 +67,7 @@ function registerSearchTools(server, userData) {
             let allTasks = searchIndex._docs || [];
             // Apply status filtering
             if (status && status.length > 0) {
-                const statusLower = status.map(s => s.toLowerCase());
+                const statusLower = status.map((s) => s.toLowerCase());
                 allTasks = allTasks.filter((task) => statusLower.includes(task.status.status.toLowerCase()));
             }
             else if (only_todo) {
@@ -101,10 +103,10 @@ function registerSearchTools(server, userData) {
             uniqueResults.set(task.id, { item: task, score: 0.1 }); // Give search results a good score
         });
         // Task ID Fallback Logic (internal IDs and custom IDs)
-        const potentialTaskIds = terms.filter(utils_1.isTaskId);
-        const potentialCustomIds = terms.filter(id => (0, utils_1.isCustomTaskId)(id) && !(0, utils_1.isTaskId)(id));
+        const potentialTaskIds = terms.filter((id) => (0, utils_1.isTaskId)(id));
+        const potentialCustomIds = terms.filter((id) => (0, utils_1.isCustomTaskId)(id) && !(0, utils_1.isTaskId)(id));
         const foundTaskIdsByFuse = new Set(Array.from(uniqueResults.keys()).map(id => id.toLowerCase()));
-        const taskIdsToFetchDirectly = potentialTaskIds.filter(id => {
+        const taskIdsToFetchDirectly = potentialTaskIds.filter((id) => {
             const lowerId = id.toLowerCase();
             return !foundTaskIdsByFuse.has(lowerId);
         });
@@ -163,7 +165,7 @@ function registerSearchTools(server, userData) {
             .map(entry => entry.item);
         // Apply status filtering
         if (status && status.length > 0) {
-            const statusLower = status.map(s => s.toLowerCase());
+            const statusLower = status.map((s) => s.toLowerCase());
             resultTasks = resultTasks.filter((task) => statusLower.includes(task.status.status.toLowerCase()));
         }
         else if (only_todo) {

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

package/dist/tools/space-tools.js

@@ -4,7 +4,9 @@ exports.registerSpaceTools = registerSpaceTools;
 const zod_1 = require("zod");
 const utils_1 = require("../shared/utils");
 function registerSpaceTools(server) {
-    server.tool("searchSpaces", [
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("searchSpaces", [
         "Searches spaces (sometimes called projects) by name or ID with fuzzy matching.",
         "If 5 or fewer spaces match, automatically fetches all lists (sometimes called boards) and folders within those spaces to provide a complete tree structure.",
         "If more than 5 spaces match, returns only space information with guidance to search more precisely.",

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,QA6DrE;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"}
+{"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,QAgErE;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

@@ -9,7 +9,9 @@ const utils_1 = require("../shared/utils");
 const image_processing_1 = require("../shared/image-processing");
 // Read-specific utility functions
 function registerTaskToolsRead(server, userData) {
-    server.tool("getTaskById", [
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("getTaskById", [
         "Get a ClickUp task with images and comments by ID.",
         "Always use this URL when referencing tasks in conversations or sharing with others.",
         "The response provides complete context including task details, comments, and status history."

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;AAcpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAgatE"}
+{"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;AAcpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAmatE"}

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

@@ -13,7 +13,9 @@ const taskStartDateSchema = zod_1.z.string().optional().describe("Optional start
 const taskTimeEstimateSchema = zod_1.z.number().optional().describe("Optional time estimate in hours (will be converted to milliseconds)");
 const taskTagsSchema = zod_1.z.array(zod_1.z.string()).optional().describe("Optional array of tag names");
 function registerTaskToolsWrite(server, userData) {
-    server.tool("addComment", (() => {
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("addComment", (() => {
         const descriptionBase = [
             "Adds a comment to a specific task.",
             "LINKING BEST PRACTICES:",
@@ -88,7 +90,7 @@ function registerTaskToolsWrite(server, userData) {
             };
         }
     });
-    server.tool("updateTask", (() => {
+    tool("updateTask", (() => {
         const descriptionBase = [
             "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.",
@@ -150,7 +152,7 @@ function registerTaskToolsWrite(server, userData) {
             if (tags !== undefined) {
                 // Get current tags
                 const currentTags = taskData.tags?.map((t) => t.name) || [];
-                const tagsToAdd = tags.filter(tag => !currentTags.includes(tag));
+                const tagsToAdd = tags.filter((tag) => !currentTags.includes(tag));
                 const tagsToRemove = currentTags.filter((tag) => !tags.includes(tag));
                 // Add new tags
                 for (const tagName of tagsToAdd) {
@@ -276,7 +278,7 @@ function registerTaskToolsWrite(server, userData) {
             };
         }
     });
-    server.tool("createTask", (() => {
+    tool("createTask", (() => {
         const descriptionBase = [
             "Creates a new task in a specific list and assigns it to specified users (defaults to current user).",
             "CRITICAL LINKING REQUIREMENTS:",

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;AAyLD,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,QAmFtD;AAyLD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA2FvD"}

package/dist/tools/time-tools.js

@@ -51,7 +51,9 @@ function formatEntryTime(timestamp) {
     return `${date.getFullYear()}-${month}-${day} ${hours}:${minutes}`;
 }
 function registerTimeToolsRead(server) {
-    server.tool("getTimeEntries", "Gets time entries for a specific task or all user's time entries. Returns last 30 days by default if no dates specified.", {
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("getTimeEntries", "Gets time entries for a specific task or all user's time entries. Returns last 30 days by default if no dates specified.", {
         task_id: zod_1.z.string().min(6).max(9).optional().describe("Optional 6-9 character task ID to filter entries. If not provided, returns all user's time entries."),
         start_date: zod_1.z.string().optional().describe("Optional start date filter as ISO date string (e.g., '2024-10-06T00:00:00+02:00'). Defaults to 30 days ago."),
         end_date: zod_1.z.string().optional().describe("Optional end date filter as ISO date string (e.g., '2024-10-06T23:59:59+02:00'). Defaults to current date."),
@@ -261,7 +263,9 @@ function processTimeEntriesData(data, task_id, start_date, end_date, include_all
     };
 }
 function registerTimeToolsWrite(server) {
-    server.tool("createTimeEntry", [
+    // Workaround: SDK 1.27+ dual Zod v3/v4 type causes TS2589 on server.tool() generics
+    const tool = server.tool.bind(server);
+    tool("createTimeEntry", [
         "Creates a time entry (books time) on a task for the current user.",
         "Use decimal hours (e.g., 0.25 for 15 minutes, 0.5 for 30 minutes, 2.5 for 2.5 hours).",
         "IMPORTANT: Before booking time, check the task's status - booking time on tasks in 'backlog', 'closed', or similar inactive states usually doesn't make sense.",

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@sebastienheyd/clickup-mcp",
-  "version": "1.6.3",
+  "version": "1.7.0",
   "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",
+  "bin": {
+    "clickup-mcp": "dist/index.js"
+  },
   "files": [
     "dist",
     "README.md"
@@ -34,13 +36,10 @@
     "agentic-coding",
     "automation"
   ],
-  "author": {
-    "name": "Sébastien HEYD",
-    "url": "https://github.com/sebastienheyd"
-  },
+  "author": "Sébastien HEYD (https://github.com/sebastienheyd)",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.22.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "fuse.js": "^7.1.0",
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",