@taazkareem/clickup-mcp-server 0.8.4 → 0.8.5

package/README.md

@@ -6,7 +6,7 @@
 
 A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.
 
-> 🚀 **Status Update:** v0.8.4 is released with security features and compatibility improvements! Added comprehensive opt-in enhanced security features, fixed Gemini compatibility (Issue #79), and resolved priority handling and subtask retrieval issues. See [Release Notes](release-notes.md) for full details.
+> 🚀 **Status Update:** v0.8.5 is released with comprehensive natural language date parsing and critical bug fixes! Added 47+ natural language patterns (100% accuracy), extended time units (months/years), dynamic number support, fixed task assignment functionality, and resolved time tracking issues. See [Release Notes](release-notes.md) for full details.
 
 ## Setup
 

package/build/server.js

@@ -45,7 +45,7 @@ const isToolEnabled = (toolName) => {
 };
 export const server = new Server({
     name: "clickup-mcp-server",
-    version: "0.8.4",
+    version: "0.8.5",
 }, {
     capabilities: {
         tools: {},

package/build/services/clickup/task/task-core.js

@@ -179,11 +179,29 @@ export class TaskServiceCore extends BaseClickUpService {
     }
     /**
      * Get a task by its ID
-     * @param taskId The ID of the task to retrieve
+     * Automatically detects custom task IDs and routes them appropriately
+     * @param taskId The ID of the task to retrieve (regular or custom)
      * @returns The task
      */
     async getTask(taskId) {
         this.logOperation('getTask', { taskId });
+        // Import the detection function here to avoid circular dependencies
+        const { isCustomTaskId } = await import('../../../tools/task/utilities.js');
+        // Test the detection function
+        const isCustom = isCustomTaskId(taskId);
+        this.logger.debug('Custom task ID detection result', {
+            taskId,
+            isCustom,
+            taskIdLength: taskId.length,
+            containsHyphen: taskId.includes('-'),
+            containsUnderscore: taskId.includes('_')
+        });
+        // Automatically detect custom task IDs and route to appropriate method
+        if (isCustom) {
+            this.logger.debug('Detected custom task ID, routing to getTaskByCustomId', { taskId });
+            return this.getTaskByCustomId(taskId);
+        }
+        this.logger.debug('Detected regular task ID, using standard getTask flow', { taskId });
         try {
             return await this.makeRequest(async () => {
                 const response = await this.client.get(`/task/${taskId}`);
@@ -196,6 +214,14 @@ export class TaskServiceCore extends BaseClickUpService {
             });
         }
         catch (error) {
+            // If this was detected as a regular task ID but failed, provide helpful error message
+            // suggesting it might be a custom ID that wasn't properly detected
+            if (error instanceof ClickUpServiceError && error.code === ErrorCode.NOT_FOUND) {
+                const { isCustomTaskId } = await import('../../../tools/task/utilities.js');
+                if (!isCustomTaskId(taskId) && (taskId.includes('-') || taskId.includes('_'))) {
+                    throw new ClickUpServiceError(`Task ${taskId} not found. If this is a custom task ID, ensure your workspace has custom task IDs enabled and you have access to the task.`, ErrorCode.NOT_FOUND, error.data);
+                }
+            }
             throw this.handleError(error, `Failed to get task ${taskId}`);
         }
     }
@@ -259,6 +285,14 @@ export class TaskServiceCore extends BaseClickUpService {
                     custom_task_ids: 'true',
                     team_id: this.teamId // team_id is required when custom_task_ids is true
                 });
+                // Debug logging for troubleshooting
+                this.logger.debug('Making custom task ID API request', {
+                    customTaskId,
+                    url,
+                    teamId: this.teamId,
+                    params: params.toString(),
+                    fullUrl: `${url}?${params.toString()}`
+                });
                 // Note: The ClickUp API documentation for GET /task/{task_id} doesn't explicitly mention
                 // filtering by list_id when custom_task_ids=true. This parameter might be ignored.
                 if (listId) {
@@ -276,6 +310,13 @@ export class TaskServiceCore extends BaseClickUpService {
             });
         }
         catch (error) {
+            // Enhanced error logging for debugging
+            this.logger.error('Custom task ID request failed', {
+                customTaskId,
+                teamId: this.teamId,
+                error: error instanceof Error ? error.message : String(error),
+                errorDetails: error
+            });
             // Provide more specific error context if possible
             if (error instanceof ClickUpServiceError && error.code === ErrorCode.NOT_FOUND) {
                 throw new ClickUpServiceError(`Task with custom ID ${customTaskId} not found or not accessible for team ${this.teamId}.`, ErrorCode.NOT_FOUND, error.data);
@@ -292,11 +333,34 @@ export class TaskServiceCore extends BaseClickUpService {
     async updateTask(taskId, updateData) {
         this.logOperation('updateTask', { taskId, ...updateData });
         try {
-            // Extract custom fields from updateData
-            const { custom_fields, ...standardFields } = updateData;
+            // Extract custom fields and assignees from updateData
+            const { custom_fields, assignees, ...standardFields } = updateData;
+            // Prepare the fields to send to API
+            let fieldsToSend = { ...standardFields };
+            // Handle assignees separately if provided
+            if (assignees !== undefined) {
+                // Get current task to compare assignees
+                const currentTask = await this.getTask(taskId);
+                const currentAssigneeIds = currentTask.assignees.map(a => a.id);
+                let assigneesToProcess;
+                if (Array.isArray(assignees)) {
+                    // If assignees is an array, calculate add/rem based on current vs new
+                    const newAssigneeIds = assignees;
+                    assigneesToProcess = {
+                        add: newAssigneeIds.filter(id => !currentAssigneeIds.includes(id)),
+                        rem: currentAssigneeIds.filter(id => !newAssigneeIds.includes(id))
+                    };
+                }
+                else {
+                    // If assignees is already in add/rem format, use it directly
+                    assigneesToProcess = assignees;
+                }
+                // Add assignees to the fields in the correct format
+                fieldsToSend.assignees = assigneesToProcess;
+            }
             // First update the standard fields
             const updatedTask = await this.makeRequest(async () => {
-                const response = await this.client.put(`/task/${taskId}`, standardFields);
+                const response = await this.client.put(`/task/${taskId}`, fieldsToSend);
                 // Handle both JSON and text responses
                 const data = response.data;
                 if (typeof data === 'string') {

package/build/tools/member.js

@@ -97,12 +97,10 @@ export async function handleResolveAssignees(parameters) {
                 m.name?.toLowerCase() === input.toLowerCase());
             return found ? found.id : null;
         });
-        // Return a plain object, not wrapped in sponsorService.createResponse
-        return { userIds: resolved };
+        return sponsorService.createResponse({ userIds: resolved }, true);
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        // Return a plain error object
-        return { error: `Failed to resolve assignees: ${errorMessage}` };
+        return sponsorService.createErrorResponse(`Failed to resolve assignees: ${errorMessage}`);
     }
 }

package/build/tools/task/bulk-operations.js

@@ -50,7 +50,7 @@ const bulkOptionsSchema = {
 const taskIdentifierSchema = {
     taskId: {
         type: "string",
-        description: "Task ID (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+        description: "Task ID (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
     },
     taskName: {
         type: "string",
@@ -62,7 +62,7 @@ const taskIdentifierSchema = {
     },
     customTaskId: {
         type: "string",
-        description: "Custom task ID (e.g., 'DEV-1234'). Only use if you want to explicitly force custom ID lookup. In most cases, use taskId which auto-detects ID format."
+        description: "Custom task ID (e.g., 'DEV-1234'). This parameter is now optional since taskId automatically handles custom IDs. Use only for explicit custom ID lookup or backward compatibility."
     }
 };
 //=============================================================================
@@ -175,7 +175,7 @@ export const updateBulkTasksTool = {
                     properties: {
                         taskId: {
                             type: "string",
-                            description: "Task ID (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                            description: "Task ID (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
                         },
                         taskName: {
                             type: "string",
@@ -267,7 +267,7 @@ export const moveBulkTasksTool = {
                     properties: {
                         taskId: {
                             type: "string",
-                            description: "Task ID (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                            description: "Task ID (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
                         },
                         taskName: {
                             type: "string",
@@ -314,7 +314,7 @@ export const deleteBulkTasksTool = {
                     properties: {
                         taskId: {
                             type: "string",
-                            description: "Task ID (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                            description: "Task ID (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
                         },
                         taskName: {
                             type: "string",

package/build/tools/task/handlers.js

@@ -110,10 +110,15 @@ async function resolveAssignees(assignees) {
     if (toResolve.length > 0) {
         try {
             const result = await handleResolveAssignees({ assignees: toResolve });
-            if (result.userIds && Array.isArray(result.userIds)) {
-                for (const userId of result.userIds) {
-                    if (userId !== null && typeof userId === 'number') {
-                        resolved.push(userId);
+            // The result is wrapped by sponsorService.createResponse, so we need to parse the JSON
+            if (result.content && Array.isArray(result.content) && result.content.length > 0) {
+                const dataText = result.content[0].text;
+                const parsedData = JSON.parse(dataText);
+                if (parsedData.userIds && Array.isArray(parsedData.userIds)) {
+                    for (const userId of parsedData.userIds) {
+                        if (userId !== null && typeof userId === 'number') {
+                            resolved.push(userId);
+                        }
                     }
                 }
             }
@@ -143,12 +148,28 @@ async function buildUpdateData(params) {
         updateData.priority = toTaskPriority(params.priority);
     }
     if (params.dueDate !== undefined) {
-        updateData.due_date = parseDueDate(params.dueDate);
-        updateData.due_date_time = true;
+        const parsedDueDate = parseDueDate(params.dueDate);
+        if (parsedDueDate !== undefined) {
+            updateData.due_date = parsedDueDate;
+            updateData.due_date_time = true;
+        }
+        else {
+            // Clear the due date by setting it to null
+            updateData.due_date = null;
+            updateData.due_date_time = false;
+        }
     }
     if (params.startDate !== undefined) {
-        updateData.start_date = parseDueDate(params.startDate);
-        updateData.start_date_time = true;
+        const parsedStartDate = parseDueDate(params.startDate);
+        if (parsedStartDate !== undefined) {
+            updateData.start_date = parsedStartDate;
+            updateData.start_date_time = true;
+        }
+        else {
+            // Clear the start date by setting it to null
+            updateData.start_date = null;
+            updateData.start_date_time = false;
+        }
     }
     // Handle time estimate if provided - convert from string to minutes
     if (params.time_estimate !== undefined) {
@@ -165,7 +186,21 @@ async function buildUpdateData(params) {
     }
     // Handle assignees if provided - resolve emails/usernames to user IDs
     if (params.assignees !== undefined) {
-        updateData.assignees = await resolveAssignees(params.assignees);
+        // Parse assignees if it's a string (from MCP serialization)
+        let assigneesArray = params.assignees;
+        if (typeof params.assignees === 'string') {
+            try {
+                assigneesArray = JSON.parse(params.assignees);
+            }
+            catch (error) {
+                console.warn('Failed to parse assignees string:', params.assignees, error);
+                assigneesArray = [];
+            }
+        }
+        const resolvedAssignees = await resolveAssignees(assigneesArray);
+        // Store the resolved assignees for processing in the updateTask method
+        // The actual add/rem logic will be handled there based on current vs new assignees
+        updateData.assignees = resolvedAssignees;
     }
     return updateData;
 }
@@ -181,7 +216,7 @@ async function findTask(params) {
         throw new Error(validationResult.errorMessage);
     }
     try {
-        // Direct path for taskId - most efficient
+        // Direct path for taskId - most efficient (now includes automatic custom ID detection)
         if (taskId) {
             const task = await taskService.getTask(taskId);
             // Add subtasks if requested
@@ -191,7 +226,8 @@ async function findTask(params) {
             }
             return { task };
         }
-        // Direct path for customTaskId - also efficient
+        // Direct path for customTaskId - for explicit custom ID requests
+        // Note: This is now mainly for backward compatibility since getTask() handles custom IDs automatically
         if (customTaskId) {
             const task = await taskService.getTaskByCustomId(customTaskId);
             // Add subtasks if requested
@@ -429,7 +465,21 @@ export async function createTaskHandler(params) {
     const priority = toTaskPriority(params.priority);
     const listId = await getListId(params.listId, params.listName);
     // Resolve assignees if provided
-    const resolvedAssignees = assignees ? await resolveAssignees(assignees) : undefined;
+    let resolvedAssignees = undefined;
+    if (assignees) {
+        // Parse assignees if it's a string (from MCP serialization)
+        let assigneesArray = assignees;
+        if (typeof assignees === 'string') {
+            try {
+                assigneesArray = JSON.parse(assignees);
+            }
+            catch (error) {
+                console.warn('Failed to parse assignees string in createTask:', assignees, error);
+                assigneesArray = [];
+            }
+        }
+        resolvedAssignees = await resolveAssignees(assigneesArray);
+    }
     const taskData = {
         name,
         description,

package/build/tools/task/single-operations.js

@@ -144,7 +144,7 @@ export const updateTaskTool = {
         properties: {
             taskId: {
                 type: "string",
-                description: "ID of task to update (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                description: "ID of task to update (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
             },
             taskName: {
                 type: "string",
@@ -229,7 +229,7 @@ export const moveTaskTool = {
         properties: {
             taskId: {
                 type: "string",
-                description: "ID of the task to move (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                description: "ID of the task to move (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
             },
             taskName: {
                 type: "string",
@@ -262,7 +262,7 @@ export const duplicateTaskTool = {
         properties: {
             taskId: {
                 type: "string",
-                description: "ID of task to duplicate (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                description: "ID of task to duplicate (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
             },
             taskName: {
                 type: "string",
@@ -289,13 +289,13 @@ export const duplicateTaskTool = {
  */
 export const getTaskTool = {
     name: "get_task",
-    description: `Gets task details by taskId (works with regular/custom IDs) or taskName. For taskName search, provide listName for faster lookup. Set subtasks=true to include all subtask details.`,
+    description: `Gets task details by taskId (automatically handles both regular and custom IDs) or taskName. For taskName search, provide listName for faster lookup. Set subtasks=true to include all subtask details.`,
     inputSchema: {
         type: "object",
         properties: {
             taskId: {
                 type: "string",
-                description: "ID of task to retrieve (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234'). The system automatically detects the ID format."
+                description: "ID of task to retrieve (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456'). Simply provide any task ID format here."
             },
             taskName: {
                 type: "string",
@@ -307,7 +307,7 @@ export const getTaskTool = {
             },
             customTaskId: {
                 type: "string",
-                description: "Custom task ID (e.g., 'DEV-1234'). Only use this if you want to explicitly force custom ID lookup. In most cases, you can just use taskId which auto-detects ID format."
+                description: "Custom task ID (e.g., 'DEV-1234'). This parameter is now optional since taskId automatically handles custom IDs. Use only for explicit custom ID lookup or backward compatibility."
             },
             subtasks: {
                 type: "boolean",
@@ -385,7 +385,7 @@ export const getTaskCommentsTool = {
         properties: {
             taskId: {
                 type: "string",
-                description: "ID of task to retrieve comments for (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                description: "ID of task to retrieve comments for (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
             },
             taskName: {
                 type: "string",
@@ -417,7 +417,7 @@ export const createTaskCommentTool = {
         properties: {
             taskId: {
                 type: "string",
-                description: "ID of task to comment on (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                description: "ID of task to comment on (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
             },
             taskName: {
                 type: "string",
@@ -454,7 +454,7 @@ export const deleteTaskTool = {
         properties: {
             taskId: {
                 type: "string",
-                description: "ID of task to delete (preferred). Works with both regular task IDs (9 characters) and custom IDs with uppercase prefixes (like 'DEV-1234')."
+                description: "ID of task to delete (preferred). Automatically detects and handles both regular task IDs (9 characters) and custom IDs (like 'DEV-1234', 'PROJ-456')."
             },
             taskName: {
                 type: "string",