@taazkareem/clickup-mcp-server 0.4.62 → 0.4.64

package/build/services/clickup/base.js

@@ -239,15 +239,6 @@ export class BaseClickUpService {
      * @param details - Details about the operation
      */
     logOperation(operation, details) {
-        // This could be enhanced to use a proper logging framework
-        console.log(`[ClickUpService] ${operation}:`, details);
-    }
-    /**
-     * Protected helper method to check if cache is available
-     * @param cacheService Optional cache service instance
-     * @returns True if caching is available and enabled
-     */
-    isCacheEnabled(cacheService) {
-        return !!cacheService && typeof cacheService.isEnabled === 'function' && cacheService.isEnabled();
+        console.log(`[${new Date().toISOString()}] ${operation}:`, details);
     }
 }

package/build/services/clickup/index.js

@@ -13,13 +13,11 @@ export { WorkspaceService } from './workspace.js';
 export { TaskService } from './task.js';
 export { ListService } from './list.js';
 export { FolderService } from './folder.js';
-export { InitializationService } from './initialization.js';
 // Import service classes for the factory function
 import { WorkspaceService } from './workspace.js';
 import { TaskService } from './task.js';
 import { ListService } from './list.js';
 import { FolderService } from './folder.js';
-import { InitializationService } from './initialization.js';
 /**
  * Factory function to create instances of all ClickUp services
  * @param config Configuration for the services
@@ -33,11 +31,6 @@ export function createClickUpServices(config) {
         workspace: workspaceService,
         task: new TaskService(apiKey, teamId, baseUrl, workspaceService),
         list: new ListService(apiKey, teamId, baseUrl, workspaceService),
-        folder: new FolderService(apiKey, teamId, baseUrl, workspaceService),
-        initialization: new InitializationService({
-            apiKey,
-            teamId,
-            baseUrl
-        })
+        folder: new FolderService(apiKey, teamId, baseUrl, workspaceService)
     };
 }

package/build/services/clickup/workspace.js

@@ -99,7 +99,7 @@ export class WorkspaceService extends BaseClickUpService {
      */
     async getWorkspaceHierarchy(forceRefresh = false) {
         try {
-            // If we have a cached result and not forcing refresh, return it
+            // If we have the hierarchy in memory and not forcing refresh, return it
             if (this.workspaceHierarchy && !forceRefresh) {
                 return this.workspaceHierarchy;
             }
@@ -164,9 +164,9 @@ export class WorkspaceService extends BaseClickUpService {
         }
     }
     /**
-     * Invalidate the workspace hierarchy cache
+     * Clear the stored workspace hierarchy, forcing a fresh fetch on next request
      */
-    invalidateWorkspaceCache() {
+    clearWorkspaceHierarchy() {
         this.workspaceHierarchy = null;
     }
     /**

package/build/tools/task.js

@@ -8,7 +8,7 @@
 import { createClickUpServices } from '../services/clickup/index.js';
 import config from '../config.js';
 import { findListIDByName } from './list.js';
-import { parseDueDate } from './utils.js';
+import { parseDueDate, formatDueDate } from './utils.js';
 // Initialize ClickUp services using the factory function
 const services = createClickUpServices({
     apiKey: config.clickupApiKey,
@@ -99,6 +99,7 @@ export const createTaskTool = {
                         name: createdTask.name,
                         url: createdTask.url,
                         status: createdTask.status?.status || "New",
+                        due_date: createdTask.due_date ? formatDueDate(Number(createdTask.due_date)) : undefined,
                         list: createdTask.list.name,
                         space: createdTask.space.name,
                         folder: createdTask.folder?.name
@@ -211,7 +212,10 @@ export const updateTaskTool = {
                         name: updatedTask.name,
                         url: updatedTask.url,
                         status: updatedTask.status?.status || "Unknown",
-                        updated: true
+                        updated: true,
+                        due_date: updatedTask.due_date ? formatDueDate(Number(updatedTask.due_date)) : undefined,
+                        list: updatedTask.list.name,
+                        folder: updatedTask.folder?.name
                     }, null, 2)
                 }]
         };
@@ -298,6 +302,7 @@ export const moveTaskTool = {
                         name: movedTask.name,
                         url: movedTask.url,
                         status: movedTask.status?.status || "Unknown",
+                        due_date: movedTask.due_date ? formatDueDate(Number(movedTask.due_date)) : undefined,
                         list: movedTask.list.name,
                         moved: true
                     }, null, 2)
@@ -389,6 +394,7 @@ export const duplicateTaskTool = {
                         name: task.name,
                         url: task.url,
                         duplicated: true,
+                        due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
                         list: task.list.name,
                         space: task.space.name,
                         folder: task.folder?.name
@@ -457,7 +463,8 @@ export const getTaskTool = {
                         description: task.description,
                         status: task.status?.status || "Unknown",
                         priority: task.priority,
-                        due_date: task.due_date,
+                        due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
+                        due_date_raw: task.due_date, // Keep raw timestamp for reference if needed
                         url: task.url,
                         list: task.list.name,
                         space: task.space.name,
@@ -543,21 +550,24 @@ export const getTasksTool = {
         };
         // Get tasks with filters
         const tasks = await taskService.getTasks(targetListId, filters);
+        // Format the tasks data to be more API friendly
+        const formattedTasks = tasks.map(task => ({
+            id: task.id,
+            name: task.name,
+            status: task.status?.status || 'Unknown',
+            url: task.url,
+            due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
+            due_date_raw: task.due_date,
+            priority: task.priority?.priority,
+            assignees: task.assignees?.map(a => a.username) || []
+        }));
         // Format response
         return {
             content: [{
                     type: "text",
                     text: JSON.stringify({
-                        list_id: targetListId,
-                        task_count: tasks.length,
-                        tasks: tasks.map((task) => ({
-                            id: task.id,
-                            name: task.name,
-                            status: task.status?.status || "Unknown",
-                            priority: task.priority,
-                            due_date: task.due_date,
-                            url: task.url
-                        }))
+                        total: tasks.length,
+                        tasks: formattedTasks
                     }, null, 2)
                 }]
         };
@@ -974,6 +984,7 @@ export async function handleCreateTask(parameters) {
                     name: task.name,
                     url: task.url,
                     status: task.status?.status || "New",
+                    due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
                     list: task.list.name,
                     space: task.space.name,
                     folder: task.folder?.name
@@ -1041,8 +1052,8 @@ export async function handleUpdateTask(parameters) {
                     url: task.url,
                     status: task.status?.status || "Unknown",
                     updated: true,
+                    due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
                     list: task.list.name,
-                    space: task.space.name,
                     folder: task.folder?.name
                 }, null, 2)
             }]
@@ -1108,6 +1119,7 @@ export async function handleMoveTask(parameters) {
                     name: task.name,
                     url: task.url,
                     moved: true,
+                    due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
                     list: task.list.name,
                     space: task.space.name,
                     folder: task.folder?.name
@@ -1171,6 +1183,7 @@ export async function handleDuplicateTask(parameters) {
                     name: task.name,
                     url: task.url,
                     duplicated: true,
+                    due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
                     list: task.list.name,
                     space: task.space.name,
                     folder: task.folder?.name
@@ -1206,21 +1219,24 @@ export async function handleGetTasks(parameters) {
     };
     // Get tasks with filters
     const tasks = await taskService.getTasks(targetListId, filters);
+    // Format the tasks data to be more API friendly
+    const formattedTasks = tasks.map(task => ({
+        id: task.id,
+        name: task.name,
+        status: task.status?.status || 'Unknown',
+        url: task.url,
+        due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
+        due_date_raw: task.due_date,
+        priority: task.priority?.priority,
+        assignees: task.assignees?.map(a => a.username) || []
+    }));
     // Format response
     return {
         content: [{
                 type: "text",
                 text: JSON.stringify({
-                    list_id: targetListId,
-                    task_count: tasks.length,
-                    tasks: tasks.map((task) => ({
-                        id: task.id,
-                        name: task.name,
-                        status: task.status?.status || "Unknown",
-                        priority: task.priority,
-                        due_date: task.due_date,
-                        url: task.url
-                    }))
+                    total: tasks.length,
+                    tasks: formattedTasks
                 }, null, 2)
             }]
     };
@@ -1260,7 +1276,24 @@ export async function handleGetTask(parameters) {
     return {
         content: [{
                 type: "text",
-                text: JSON.stringify(task, null, 2)
+                text: JSON.stringify({
+                    id: task.id,
+                    name: task.name,
+                    description: task.description,
+                    status: task.status?.status || "Unknown",
+                    priority: task.priority,
+                    due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
+                    due_date_raw: task.due_date, // Keep raw timestamp for reference if needed
+                    url: task.url,
+                    list: task.list.name,
+                    space: task.space.name,
+                    folder: task.folder?.name,
+                    creator: task.creator,
+                    assignees: task.assignees,
+                    tags: task.tags,
+                    time_estimate: task.time_estimate,
+                    time_spent: task.time_spent,
+                }, null, 2)
             }]
     };
 }

package/build/tools/utils.js

@@ -41,25 +41,52 @@ export function parseDueDate(dateString) {
             today.setHours(23, 59, 59, 999);
             return today.getTime();
         }
-        if (lowerDate === 'tomorrow') {
-            const tomorrow = new Date();
-            tomorrow.setDate(tomorrow.getDate() + 1);
-            tomorrow.setHours(23, 59, 59, 999);
-            return tomorrow.getTime();
-        }
-        if (lowerDate.includes('next week')) {
-            const nextWeek = new Date();
-            nextWeek.setDate(nextWeek.getDate() + 7);
-            nextWeek.setHours(23, 59, 59, 999);
-            return nextWeek.getTime();
-        }
-        if (lowerDate.includes('next month')) {
-            const nextMonth = new Date();
-            nextMonth.setMonth(nextMonth.getMonth() + 1);
-            nextMonth.setHours(23, 59, 59, 999);
-            return nextMonth.getTime();
+        // Handle relative dates with specific times
+        const relativeTimeRegex = /(?:(\d+)\s*(days?|weeks?|months?)\s*from\s*now|tomorrow|next\s+(?:week|month))\s*(?:at\s+(\d+)(?::(\d+))?\s*(am|pm)?)?/i;
+        const match = lowerDate.match(relativeTimeRegex);
+        if (match) {
+            const date = new Date();
+            const [_, amount, unit, hours, minutes, meridian] = match;
+            // Calculate the future date
+            if (amount && unit) {
+                const value = parseInt(amount);
+                if (unit.startsWith('day')) {
+                    date.setDate(date.getDate() + value);
+                }
+                else if (unit.startsWith('week')) {
+                    date.setDate(date.getDate() + (value * 7));
+                }
+                else if (unit.startsWith('month')) {
+                    date.setMonth(date.getMonth() + value);
+                }
+            }
+            else if (lowerDate.startsWith('tomorrow')) {
+                date.setDate(date.getDate() + 1);
+            }
+            else if (lowerDate.includes('next week')) {
+                date.setDate(date.getDate() + 7);
+            }
+            else if (lowerDate.includes('next month')) {
+                date.setMonth(date.getMonth() + 1);
+            }
+            // Set the time if specified
+            if (hours) {
+                let parsedHours = parseInt(hours);
+                const parsedMinutes = minutes ? parseInt(minutes) : 0;
+                // Convert to 24-hour format if meridian is specified
+                if (meridian?.toLowerCase() === 'pm' && parsedHours < 12)
+                    parsedHours += 12;
+                if (meridian?.toLowerCase() === 'am' && parsedHours === 12)
+                    parsedHours = 0;
+                date.setHours(parsedHours, parsedMinutes, 0, 0);
+            }
+            else {
+                // Default to end of day if no time specified
+                date.setHours(23, 59, 59, 999);
+            }
+            return date.getTime();
         }
-        // Handle hours/days/weeks/months from now
+        // Handle hours from now
         const hoursRegex = /(\d+)\s*hours?\s*from\s*now/i;
         const daysRegex = /(\d+)\s*days?\s*from\s*now/i;
         const weeksRegex = /(\d+)\s*weeks?\s*from\s*now/i;
@@ -93,3 +120,31 @@ export function parseDueDate(dateString) {
         return undefined;
     }
 }
+/**
+ * Format a due date timestamp into a human-readable string
+ *
+ * @param timestamp Unix timestamp in milliseconds
+ * @returns Formatted date string or undefined if timestamp is invalid
+ */
+export function formatDueDate(timestamp) {
+    if (!timestamp)
+        return undefined;
+    try {
+        const date = new Date(timestamp);
+        if (isNaN(date.getTime()))
+            return undefined;
+        // Format: "March 10, 2025 at 10:56 PM"
+        return date.toLocaleString('en-US', {
+            year: 'numeric',
+            month: 'long',
+            day: 'numeric',
+            hour: 'numeric',
+            minute: '2-digit',
+            hour12: true
+        }).replace(' at', ',');
+    }
+    catch (error) {
+        console.warn(`Failed to format due date: ${timestamp}`, error);
+        return undefined;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taazkareem/clickup-mcp-server",
-  "version": "0.4.62",
+  "version": "0.4.64",
   "description": "ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",
@@ -18,9 +18,7 @@
     "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
     "start": "node build/index.js",
     "dev": "tsc -w",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm test",
-    "test": "echo \"No tests specified\" && exit 0"
+    "prepare": "npm run build"
   },
   "keywords": [
     "clickup",

package/build/services/clickup/initialization.js

@@ -1,28 +0,0 @@
-import { WorkspaceService } from "./workspace.js";
-/**
- * Service responsible for initializing the server state
- * Handles preloading workspace data
- */
-export class InitializationService {
-    constructor(config) {
-        // Create workspace service
-        this.workspaceService = new WorkspaceService(config.apiKey, config.teamId, config.baseUrl);
-    }
-    /**
-     * Preload workspace hierarchy data on server startup
-     * This loads the entire workspace tree for faster initial access
-     */
-    async preloadWorkspaceData() {
-        try {
-            console.log("Preloading workspace data...");
-            const startTime = Date.now();
-            // Force refresh to get the latest data
-            await this.workspaceService.getWorkspaceHierarchy(true);
-            const duration = (Date.now() - startTime) / 1000;
-            console.log(`Workspace data preloaded successfully in ${duration.toFixed(2)}s`);
-        }
-        catch (error) {
-            console.error("Failed to preload workspace data:", error);
-        }
-    }
-}