@taazkareem/clickup-mcp-server 0.4.72 → 0.4.73

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

@@ -0,0 +1,224 @@
+/**
+ * ClickUp MCP Bulk Task Operations
+ *
+ * This module defines tools for bulk task operations including creating,
+ * updating, moving, and deleting multiple tasks at once.
+ */
+import { clickUpServices } from '../../services/shared.js';
+import { BulkService } from '../../services/clickup/bulk.js';
+// Initialize services
+const { task: taskService } = clickUpServices;
+const bulkService = new BulkService(taskService);
+//=============================================================================
+// COMMON SCHEMA DEFINITIONS
+//=============================================================================
+// Common schema definitions
+const bulkOptionsSchema = {
+    oneOf: [
+        {
+            type: "object",
+            description: "Optional processing settings",
+            properties: {
+                batchSize: {
+                    type: "number",
+                    description: "Tasks per batch (default: 10)"
+                },
+                concurrency: {
+                    type: "number",
+                    description: "Parallel operations (default: 3)"
+                },
+                continueOnError: {
+                    type: "boolean",
+                    description: "Continue if some tasks fail"
+                },
+                retryCount: {
+                    type: "number",
+                    description: "Retry attempts for failures"
+                }
+            }
+        },
+        {
+            type: "string",
+            description: "JSON string representing options. Will be parsed automatically."
+        }
+    ],
+    description: "Processing options (or JSON string representing options)"
+};
+const taskIdentifierSchema = {
+    taskId: {
+        type: "string",
+        description: "Task ID (preferred). Use instead of taskName if available."
+    },
+    taskName: {
+        type: "string",
+        description: "Task name. Requires listName when used."
+    },
+    listName: {
+        type: "string",
+        description: "REQUIRED with taskName: List containing the task."
+    }
+};
+//=============================================================================
+// BULK TASK OPERATION TOOLS
+//=============================================================================
+/**
+ * Tool definition for creating multiple tasks at once
+ */
+export const createBulkTasksTool = {
+    name: "create_bulk_tasks",
+    description: "Create multiple tasks in a list efficiently. You MUST provide:\n1. An array of tasks with required properties\n2. Either listId or listName to specify the target list\n\nOptional: Configure batch size and concurrency for performance.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            listId: {
+                type: "string",
+                description: "ID of list for new tasks (preferred). Use this instead of listName if you have it."
+            },
+            listName: {
+                type: "string",
+                description: "Name of list for new tasks. Only use if you don't have listId."
+            },
+            tasks: {
+                type: "array",
+                description: "Array of tasks to create. Each task must have at least a name.",
+                items: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "Task name with emoji prefix"
+                        },
+                        description: {
+                            type: "string",
+                            description: "Plain text description"
+                        },
+                        markdown_description: {
+                            type: "string",
+                            description: "Markdown description (overrides plain text)"
+                        },
+                        status: {
+                            type: "string",
+                            description: "Task status (uses list default if omitted)"
+                        },
+                        priority: {
+                            type: "number",
+                            description: "Priority 1-4 (1=urgent, 4=low)"
+                        },
+                        dueDate: {
+                            type: "string",
+                            description: "Due date. Supports Unix timestamps (in milliseconds) and natural language expressions like '1 hour from now', 'tomorrow', 'next week', etc."
+                        }
+                    },
+                    required: ["name"]
+                }
+            },
+            options: bulkOptionsSchema
+        },
+        required: ["tasks"]
+    }
+};
+/**
+ * Tool definition for updating multiple tasks at once
+ */
+export const updateBulkTasksTool = {
+    name: "update_bulk_tasks",
+    description: "Update multiple tasks efficiently. For each task, you MUST provide either:\n1. taskId alone (preferred)\n2. taskName + listName\n\nOnly specified fields will be updated for each task.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            tasks: {
+                type: "array",
+                description: "Array of tasks to update",
+                items: {
+                    type: "object",
+                    properties: {
+                        ...taskIdentifierSchema,
+                        name: {
+                            type: "string",
+                            description: "New name with emoji prefix"
+                        },
+                        description: {
+                            type: "string",
+                            description: "New plain text description"
+                        },
+                        markdown_description: {
+                            type: "string",
+                            description: "New markdown description"
+                        },
+                        status: {
+                            type: "string",
+                            description: "New status"
+                        },
+                        priority: {
+                            type: ["number", "null"],
+                            enum: [1, 2, 3, 4, null],
+                            description: "New priority (1-4 or null)"
+                        },
+                        dueDate: {
+                            type: "string",
+                            description: "New due date. Supports Unix timestamps (in milliseconds) and natural language expressions like '1 hour from now', 'tomorrow', etc."
+                        }
+                    }
+                }
+            },
+            options: bulkOptionsSchema
+        },
+        required: ["tasks"]
+    }
+};
+/**
+ * Tool definition for moving multiple tasks at once
+ */
+export const moveBulkTasksTool = {
+    name: "move_bulk_tasks",
+    description: "Move multiple tasks to a different list efficiently. For each task, you MUST provide either:\n1. taskId alone (preferred)\n2. taskName + listName\n\nWARNING: Task statuses may reset if target list has different status options.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            tasks: {
+                type: "array",
+                description: "Array of tasks to move",
+                items: {
+                    type: "object",
+                    properties: {
+                        ...taskIdentifierSchema
+                    }
+                }
+            },
+            targetListId: {
+                type: "string",
+                description: "ID of destination list (preferred). Use instead of targetListName if available."
+            },
+            targetListName: {
+                type: "string",
+                description: "Name of destination list. Only use if you don't have targetListId."
+            },
+            options: bulkOptionsSchema
+        },
+        required: ["tasks"]
+    }
+};
+/**
+ * Tool definition for deleting multiple tasks at once
+ */
+export const deleteBulkTasksTool = {
+    name: "delete_bulk_tasks",
+    description: "⚠️ PERMANENTLY DELETE multiple tasks. This action cannot be undone. For each task, you MUST provide either:\n1. taskId alone (preferred and safest)\n2. taskName + listName (use with caution).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            tasks: {
+                type: "array",
+                description: "Array of tasks to delete",
+                items: {
+                    type: "object",
+                    properties: {
+                        ...taskIdentifierSchema
+                    }
+                }
+            },
+            options: bulkOptionsSchema
+        },
+        required: ["tasks"]
+    }
+};

package/build/tools/task/handlers.js

@@ -0,0 +1,213 @@
+/**
+ * ClickUp MCP Task Operation Handlers
+ *
+ * This module implements the handlers for task operations, both for single task
+ * and bulk operations. These handlers are used by the tool definitions.
+ */
+import { toTaskPriority } from '../../services/clickup/types.js';
+import { clickUpServices } from '../../services/shared.js';
+import { BulkService } from '../../services/clickup/bulk.js';
+import { parseDueDate } from '../utils.js';
+import { validateTaskIdentification, validateListIdentification, validateTaskUpdateData, validateBulkTasks, parseBulkOptions, resolveTaskIdWithValidation, resolveListIdWithValidation } from './utilities.js';
+// Use shared services instance
+const { task: taskService, list: listService } = clickUpServices;
+// Create a bulk service instance that uses the task service
+const bulkService = new BulkService(taskService);
+//=============================================================================
+// SHARED UTILITY FUNCTIONS
+//=============================================================================
+/**
+ * Build task update data from parameters
+ */
+function buildUpdateData(params) {
+    const updateData = {};
+    if (params.name !== undefined)
+        updateData.name = params.name;
+    if (params.description !== undefined)
+        updateData.description = params.description;
+    if (params.markdown_description !== undefined)
+        updateData.markdown_description = params.markdown_description;
+    if (params.status !== undefined)
+        updateData.status = params.status;
+    if (params.priority !== undefined)
+        updateData.priority = toTaskPriority(params.priority);
+    if (params.dueDate !== undefined)
+        updateData.due_date = parseDueDate(params.dueDate);
+    return updateData;
+}
+/**
+ * Process a task identification validation, returning the task ID
+ */
+async function getTaskId(taskId, taskName, listName) {
+    validateTaskIdentification(taskId, taskName, listName);
+    return await resolveTaskIdWithValidation(taskId, taskName, listName);
+}
+/**
+ * Process a list identification validation, returning the list ID
+ */
+async function getListId(listId, listName) {
+    validateListIdentification(listId, listName);
+    return await resolveListIdWithValidation(listId, listName);
+}
+/**
+ * Extract and build task filters from parameters
+ */
+function buildTaskFilters(params) {
+    const { subtasks, statuses, page, order_by, reverse } = params;
+    const filters = {};
+    if (subtasks !== undefined)
+        filters.subtasks = subtasks;
+    if (statuses !== undefined)
+        filters.statuses = statuses;
+    if (page !== undefined)
+        filters.page = page;
+    if (order_by !== undefined)
+        filters.order_by = order_by;
+    if (reverse !== undefined)
+        filters.reverse = reverse;
+    return filters;
+}
+/**
+ * Map tasks for bulk operations, resolving task IDs
+ */
+async function mapTaskIds(tasks) {
+    return Promise.all(tasks.map(async (task) => {
+        validateTaskIdentification(task.taskId, task.taskName, task.listName);
+        return await resolveTaskIdWithValidation(task.taskId, task.taskName, task.listName);
+    }));
+}
+//=============================================================================
+// SINGLE TASK OPERATIONS
+//=============================================================================
+/**
+ * Handler for creating a task
+ */
+export async function createTaskHandler(params) {
+    const { name, description, markdown_description, status, dueDate } = params;
+    if (!name)
+        throw new Error("Task name is required");
+    // Use our helper function to validate and convert priority
+    const priority = toTaskPriority(params.priority);
+    const listId = await getListId(params.listId, params.listName);
+    return await taskService.createTask(listId, {
+        name,
+        description,
+        markdown_description,
+        status,
+        priority,
+        due_date: dueDate ? parseDueDate(dueDate) : undefined
+    });
+}
+/**
+ * Handler for updating a task
+ */
+export async function updateTaskHandler(params) {
+    validateTaskUpdateData(params);
+    const taskId = await getTaskId(params.taskId, params.taskName, params.listName);
+    return await taskService.updateTask(taskId, buildUpdateData(params));
+}
+/**
+ * Handler for moving a task
+ */
+export async function moveTaskHandler(params) {
+    const taskId = await getTaskId(params.taskId, params.taskName, params.listName);
+    const listId = await getListId(params.listId, params.listName);
+    return await taskService.moveTask(taskId, listId);
+}
+/**
+ * Handler for duplicating a task
+ */
+export async function duplicateTaskHandler(params) {
+    const taskId = await getTaskId(params.taskId, params.taskName, params.listName);
+    let listId;
+    if (params.listId || params.listName) {
+        listId = await getListId(params.listId, params.listName);
+    }
+    return await taskService.duplicateTask(taskId, listId);
+}
+/**
+ * Handler for getting a task
+ */
+export async function getTaskHandler(params) {
+    const taskId = await getTaskId(params.taskId, params.taskName, params.listName);
+    return await taskService.getTask(taskId);
+}
+/**
+ * Handler for getting tasks
+ */
+export async function getTasksHandler(params) {
+    const listId = await getListId(params.listId, params.listName);
+    return await taskService.getTasks(listId, buildTaskFilters(params));
+}
+/**
+ * Handler for deleting a task
+ */
+export async function deleteTaskHandler(params) {
+    const taskId = await getTaskId(params.taskId, params.taskName, params.listName);
+    await taskService.deleteTask(taskId);
+    return true;
+}
+/**
+ * Handler for getting task comments
+ */
+export async function getTaskCommentsHandler(params) {
+    const taskId = await getTaskId(params.taskId, params.taskName, params.listName);
+    const { start, startId } = params;
+    return await taskService.getTaskComments(taskId, start, startId);
+}
+//=============================================================================
+// BULK TASK OPERATIONS
+//=============================================================================
+/**
+ * Handler for creating multiple tasks
+ */
+export async function createBulkTasksHandler(params) {
+    validateBulkTasks(params.tasks);
+    const listId = await getListId(params.listId, params.listName);
+    // Process tasks - prepare data for each task
+    const tasks = params.tasks.map(task => {
+        const processedTask = { ...task };
+        if (task.dueDate) {
+            processedTask.due_date = parseDueDate(task.dueDate);
+            delete processedTask.dueDate;
+        }
+        return processedTask;
+    });
+    const result = await bulkService.createTasks(listId, tasks, parseBulkOptions(params.options));
+    return result.successful;
+}
+/**
+ * Handler for updating multiple tasks
+ */
+export async function updateBulkTasksHandler(params) {
+    validateBulkTasks(params.tasks);
+    const updates = await Promise.all(params.tasks.map(async (task) => {
+        validateTaskUpdateData(task);
+        const taskId = await getTaskId(task.taskId, task.taskName, task.listName);
+        return { id: taskId, data: buildUpdateData(task) };
+    }));
+    const result = await bulkService.updateTasks(updates, parseBulkOptions(params.options));
+    return result.successful;
+}
+/**
+ * Handler for moving multiple tasks
+ */
+export async function moveBulkTasksHandler(params) {
+    validateBulkTasks(params.tasks);
+    if (!params.targetListId && !params.targetListName) {
+        throw new Error("Either targetListId or targetListName must be provided");
+    }
+    const targetListId = await getListId(params.targetListId, params.targetListName);
+    const taskIds = await mapTaskIds(params.tasks);
+    const result = await bulkService.moveTasks(taskIds, targetListId, parseBulkOptions(params.options));
+    return result.successful;
+}
+/**
+ * Handler for deleting multiple tasks
+ */
+export async function deleteBulkTasksHandler(params) {
+    validateBulkTasks(params.tasks);
+    const taskIds = await mapTaskIds(params.tasks);
+    await bulkService.deleteTasks(taskIds, parseBulkOptions(params.options));
+    return taskIds.map(() => true);
+}

package/build/tools/task/index.js

@@ -0,0 +1,19 @@
+/**
+ * ClickUp MCP Task Tools
+ *
+ * This module re-exports all task-related tools and handlers.
+ */
+// Re-export from main module
+export * from './main.js';
+// Re-export single task operation tools
+export { createTaskTool, getTaskTool, getTasksTool, updateTaskTool, moveTaskTool, duplicateTaskTool, deleteTaskTool, getTaskCommentsTool } from './single-operations.js';
+// Re-export bulk task operation tools
+export { createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool } from './bulk-operations.js';
+// Re-export handlers
+export { 
+// Single task operation handlers
+createTaskHandler, getTaskHandler, getTasksHandler, updateTaskHandler, moveTaskHandler, duplicateTaskHandler, deleteTaskHandler, getTaskCommentsHandler, 
+// Bulk task operation handlers
+createBulkTasksHandler, updateBulkTasksHandler, moveBulkTasksHandler, deleteBulkTasksHandler } from './handlers.js';
+// Re-export utilities
+export { formatTaskData, validateTaskIdentification, validateListIdentification, validateTaskUpdateData, validateBulkTasks, parseBulkOptions, resolveTaskIdWithValidation, resolveListIdWithValidation } from './utilities.js';

package/build/tools/task/main.js

@@ -0,0 +1,89 @@
+/**
+ * ClickUp MCP Task Tools
+ *
+ * This is the main task module that connects tool definitions to their handlers.
+ * The actual implementations are organized in sub-modules for better maintainability.
+ */
+import { sponsorService } from '../../utils/sponsor-service.js';
+// Import tool definitions
+import { createTaskTool, getTaskTool, getTasksTool, updateTaskTool, moveTaskTool, duplicateTaskTool, deleteTaskTool, getTaskCommentsTool } from './single-operations.js';
+import { createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool } from './bulk-operations.js';
+// Import handlers
+import { createTaskHandler, getTaskHandler, getTasksHandler, updateTaskHandler, moveTaskHandler, duplicateTaskHandler, deleteTaskHandler, getTaskCommentsHandler, createBulkTasksHandler, updateBulkTasksHandler, moveBulkTasksHandler, deleteBulkTasksHandler } from './handlers.js';
+//=============================================================================
+// HANDLER WRAPPER UTILITY
+//=============================================================================
+/**
+ * Creates a wrapped handler function with standard error handling and response formatting
+ */
+function createHandlerWrapper(handler, formatResponse = (result) => result) {
+    return async (parameters) => {
+        try {
+            const result = await handler(parameters);
+            return sponsorService.createResponse(formatResponse(result), true);
+        }
+        catch (error) {
+            return sponsorService.createErrorResponse(error, parameters);
+        }
+    };
+}
+//=============================================================================
+// SINGLE TASK OPERATIONS - HANDLER IMPLEMENTATIONS
+//=============================================================================
+export const handleCreateTask = createHandlerWrapper(createTaskHandler);
+export const handleGetTask = createHandlerWrapper(getTaskHandler);
+export const handleGetTasks = createHandlerWrapper(getTasksHandler, (tasks) => ({
+    tasks,
+    count: tasks.length
+}));
+export const handleUpdateTask = createHandlerWrapper(updateTaskHandler);
+export const handleMoveTask = createHandlerWrapper(moveTaskHandler);
+export const handleDuplicateTask = createHandlerWrapper(duplicateTaskHandler);
+export const handleDeleteTask = createHandlerWrapper(deleteTaskHandler, () => ({
+    success: true,
+    message: "Task deleted successfully"
+}));
+export const handleGetTaskComments = createHandlerWrapper(getTaskCommentsHandler, (comments) => ({
+    comments,
+    count: comments.length
+}));
+//=============================================================================
+// BULK TASK OPERATIONS - HANDLER IMPLEMENTATIONS
+//=============================================================================
+export const handleCreateBulkTasks = createHandlerWrapper(createBulkTasksHandler, (tasks) => ({
+    tasks,
+    count: tasks.length
+}));
+export const handleUpdateBulkTasks = createHandlerWrapper(updateBulkTasksHandler, (tasks) => ({
+    tasks,
+    count: tasks.length
+}));
+export const handleMoveBulkTasks = createHandlerWrapper(moveBulkTasksHandler, (tasks) => ({
+    tasks,
+    count: tasks.length
+}));
+export const handleDeleteBulkTasks = createHandlerWrapper(deleteBulkTasksHandler, (results) => ({
+    success: true,
+    count: results.length,
+    results
+}));
+//=============================================================================
+// TOOL DEFINITIONS AND HANDLERS EXPORT
+//=============================================================================
+// Tool definitions with their handler mappings
+export const taskTools = [
+    // Single task operations
+    { definition: createTaskTool, handler: handleCreateTask },
+    { definition: getTaskTool, handler: handleGetTask },
+    { definition: getTasksTool, handler: handleGetTasks },
+    { definition: updateTaskTool, handler: handleUpdateTask },
+    { definition: moveTaskTool, handler: handleMoveTask },
+    { definition: duplicateTaskTool, handler: handleDuplicateTask },
+    { definition: deleteTaskTool, handler: handleDeleteTask },
+    { definition: getTaskCommentsTool, handler: handleGetTaskComments },
+    // Bulk task operations
+    { definition: createBulkTasksTool, handler: handleCreateBulkTasks },
+    { definition: updateBulkTasksTool, handler: handleUpdateBulkTasks },
+    { definition: moveBulkTasksTool, handler: handleMoveBulkTasks },
+    { definition: deleteBulkTasksTool, handler: handleDeleteBulkTasks }
+];