@taazkareem/clickup-mcp-server 0.6.0 → 0.6.2

package/build/tools/task/attachments.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp MCP Task Attachment Tool
  *
  * This module implements a tool for attaching files to ClickUp tasks

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

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp MCP Bulk Task Operations
  *
  * This module defines tools for bulk task operations including creating,
@@ -124,6 +127,13 @@ Notes:
                         dueDate: {
                             type: "string",
                             description: "Due date. Supports Unix timestamps (in milliseconds) and natural language expressions like '1 hour from now', 'tomorrow', 'next week', etc."
+                        },
+                        tags: {
+                            type: "array",
+                            items: {
+                                type: "string"
+                            },
+                            description: "Optional array of tag names to assign to the task. The tags must already exist in the space."
                         }
                     },
                     required: ["name"]

package/build/tools/task/handlers.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp MCP Task Operation Handlers
  *
  * This module implements the handlers for task operations, both for single task
@@ -83,7 +86,7 @@ async function mapTaskIds(tasks) {
  * Handler for creating a task
  */
 export async function createTaskHandler(params) {
-    const { name, description, markdown_description, status, dueDate, parent } = params;
+    const { name, description, markdown_description, status, dueDate, parent, tags } = params;
     if (!name)
         throw new Error("Task name is required");
     // Use our helper function to validate and convert priority
@@ -96,7 +99,8 @@ export async function createTaskHandler(params) {
         status,
         priority,
         due_date: dueDate ? parseDueDate(dueDate) : undefined,
-        parent
+        parent,
+        tags
     });
 }
 /**
@@ -185,6 +189,61 @@ export async function createTaskCommentHandler(params) {
         throw error;
     }
 }
+/**
+ * Handler for getting workspace tasks with filtering
+ */
+export async function getWorkspaceTasksHandler(taskService, params) {
+    try {
+        // Require at least one filter parameter
+        const hasFilter = [
+            'tags',
+            'list_ids',
+            'folder_ids',
+            'space_ids',
+            'statuses',
+            'assignees',
+            'date_created_gt',
+            'date_created_lt',
+            'date_updated_gt',
+            'date_updated_lt',
+            'due_date_gt',
+            'due_date_lt'
+        ].some(key => params[key] !== undefined);
+        if (!hasFilter) {
+            throw new Error('At least one filter parameter is required (tags, list_ids, folder_ids, space_ids, statuses, assignees, or date filters)');
+        }
+        // Create filter object from parameters
+        const filters = {
+            tags: params.tags,
+            list_ids: params.list_ids,
+            folder_ids: params.folder_ids,
+            space_ids: params.space_ids,
+            statuses: params.statuses,
+            include_closed: params.include_closed,
+            include_archived_lists: params.include_archived_lists,
+            include_closed_lists: params.include_closed_lists,
+            archived: params.archived,
+            order_by: params.order_by,
+            reverse: params.reverse,
+            due_date_gt: params.due_date_gt,
+            due_date_lt: params.due_date_lt,
+            date_created_gt: params.date_created_gt,
+            date_created_lt: params.date_created_lt,
+            date_updated_gt: params.date_updated_gt,
+            date_updated_lt: params.date_updated_lt,
+            assignees: params.assignees,
+            page: params.page,
+            detail_level: params.detail_level || 'detailed'
+        };
+        // Get tasks with adaptive response format support
+        const response = await taskService.getWorkspaceTasks(filters);
+        // Return the response without adding the redundant _note field
+        return response;
+    }
+    catch (error) {
+        throw new Error(`Failed to get workspace tasks: ${error.message}`);
+    }
+}
 //=============================================================================
 // BULK TASK OPERATIONS
 //=============================================================================

package/build/tools/task/index.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp MCP Task Tools
  *
  * This module re-exports all task-related tools and handlers.
@@ -9,6 +12,8 @@ export * from './main.js';
 export { createTaskTool, getTaskTool, getTasksTool, updateTaskTool, moveTaskTool, duplicateTaskTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool } from './single-operations.js';
 // Re-export bulk task operation tools
 export { createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool } from './bulk-operations.js';
+// Re-export workspace task operation tools
+export { getWorkspaceTasksTool } from './workspace-operations.js';
 // Re-export attachment tool
 export { attachTaskFileTool, handleAttachTaskFile } from './attachments.js';
 // Re-export handlers
@@ -16,6 +21,8 @@ export {
 // Single task operation handlers
 createTaskHandler, getTaskHandler, getTasksHandler, updateTaskHandler, moveTaskHandler, duplicateTaskHandler, deleteTaskHandler, getTaskCommentsHandler, createTaskCommentHandler, 
 // Bulk task operation handlers
-createBulkTasksHandler, updateBulkTasksHandler, moveBulkTasksHandler, deleteBulkTasksHandler } from './handlers.js';
+createBulkTasksHandler, updateBulkTasksHandler, moveBulkTasksHandler, deleteBulkTasksHandler, 
+// Team task operation handlers
+getWorkspaceTasksHandler } from './handlers.js';
 // Re-export utilities
 export { formatTaskData, validateTaskIdentification, validateListIdentification, validateTaskUpdateData, validateBulkTasks, parseBulkOptions, resolveTaskIdWithValidation, resolveListIdWithValidation } from './utilities.js';

package/build/tools/task/main.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp MCP Task Tools
  *
  * This is the main task module that connects tool definitions to their handlers.
@@ -8,8 +11,12 @@ import { sponsorService } from '../../utils/sponsor-service.js';
 // Import tool definitions
 import { createTaskTool, getTaskTool, getTasksTool, updateTaskTool, moveTaskTool, duplicateTaskTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool } from './single-operations.js';
 import { createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool } from './bulk-operations.js';
+import { getWorkspaceTasksTool } from './workspace-operations.js';
 // Import handlers
-import { createTaskHandler, getTaskHandler, getTasksHandler, updateTaskHandler, moveTaskHandler, duplicateTaskHandler, deleteTaskHandler, getTaskCommentsHandler, createTaskCommentHandler, createBulkTasksHandler, updateBulkTasksHandler, moveBulkTasksHandler, deleteBulkTasksHandler } from './handlers.js';
+import { createTaskHandler, getTaskHandler, getTasksHandler, updateTaskHandler, moveTaskHandler, duplicateTaskHandler, deleteTaskHandler, getTaskCommentsHandler, createTaskCommentHandler, createBulkTasksHandler, updateBulkTasksHandler, moveBulkTasksHandler, deleteBulkTasksHandler, getWorkspaceTasksHandler } from './handlers.js';
+// Import shared services
+import { clickUpServices } from '../../services/shared.js';
+const { task: taskService } = clickUpServices;
 //=============================================================================
 // HANDLER WRAPPER UTILITY
 //=============================================================================
@@ -76,6 +83,13 @@ export const handleDeleteBulkTasks = createHandlerWrapper(deleteBulkTasksHandler
     results
 }));
 //=============================================================================
+// WORKSPACE TASK OPERATIONS - HANDLER IMPLEMENTATIONS
+//=============================================================================
+export const handleGetWorkspaceTasks = createHandlerWrapper(
+// This adapts the new handler signature to match what createHandlerWrapper expects
+(params) => getWorkspaceTasksHandler(taskService, params), (response) => response // Pass through the response as is
+);
+//=============================================================================
 // TOOL DEFINITIONS AND HANDLERS EXPORT
 //=============================================================================
 // Tool definitions with their handler mappings
@@ -94,5 +108,7 @@ export const taskTools = [
     { definition: createBulkTasksTool, handler: handleCreateBulkTasks },
     { definition: updateBulkTasksTool, handler: handleUpdateBulkTasks },
     { definition: moveBulkTasksTool, handler: handleMoveBulkTasks },
-    { definition: deleteBulkTasksTool, handler: handleDeleteBulkTasks }
+    { definition: deleteBulkTasksTool, handler: handleDeleteBulkTasks },
+    // Team task operations
+    { definition: getWorkspaceTasksTool, handler: handleGetWorkspaceTasks }
 ];

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

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp MCP Single Task Operations
  *
  * This module defines tools for single task operations including creating,
@@ -97,6 +100,13 @@ Notes:
             parent: {
                 type: "string",
                 description: "Optional ID of the parent task. When specified, this task will be created as a subtask of the specified parent task."
+            },
+            tags: {
+                type: "array",
+                items: {
+                    type: "string"
+                },
+                description: "Optional array of tag names to assign to the task. The tags must already exist in the space."
             }
         }
     }

package/build/tools/task/utilities.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp MCP Task Utilities
  *
  * This module provides utility functions for task-related operations including
@@ -17,13 +20,47 @@ const { workspace: workspaceService } = clickUpServices;
 export function formatTaskData(task, additional = {}) {
     return {
         id: task.id,
+        custom_id: task.custom_id,
         name: task.name,
+        text_content: task.text_content,
+        description: task.description,
         url: task.url,
         status: task.status?.status || "Unknown",
+        status_color: task.status?.color,
+        orderindex: task.orderindex,
+        date_created: task.date_created,
+        date_updated: task.date_updated,
+        date_closed: task.date_closed,
+        creator: task.creator,
+        assignees: task.assignees,
+        watchers: task.watchers,
+        checklists: task.checklists,
+        tags: task.tags,
+        parent: task.parent,
+        priority: task.priority,
         due_date: task.due_date ? formatDueDate(Number(task.due_date)) : undefined,
-        list: task.list.name,
-        space: task.space.name,
-        folder: task.folder?.name,
+        start_date: task.start_date,
+        time_estimate: task.time_estimate,
+        time_spent: task.time_spent,
+        custom_fields: task.custom_fields,
+        dependencies: task.dependencies,
+        linked_tasks: task.linked_tasks,
+        team_id: task.team_id,
+        list: {
+            id: task.list.id,
+            name: task.list.name,
+            access: task.list.access
+        },
+        folder: task.folder ? {
+            id: task.folder.id,
+            name: task.folder.name,
+            hidden: task.folder.hidden,
+            access: task.folder.access
+        } : null,
+        space: {
+            id: task.space.id,
+            name: task.space.name
+        },
         ...additional
     };
 }

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

@@ -0,0 +1,222 @@
+/**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
+ * ClickUp MCP Workspace Task Operations
+ *
+ * This module defines tools for workspace-wide task operations, including
+ * filtering tasks across the entire workspace with tag-based filtering.
+ */
+/**
+ * Tool definition for getting workspace tasks
+ */
+export const getWorkspaceTasksTool = {
+    name: "get_workspace_tasks",
+    description: `Purpose: Retrieve tasks from across the entire workspace with powerful filtering options, including tag-based filtering.
+
+Valid Usage:
+1. Apply any combination of filters (tags, lists, folders, spaces, statuses, etc.)
+2. Use pagination to manage large result sets
+
+Requirements:
+- At least one filter parameter is REQUIRED (tags, list_ids, folder_ids, space_ids, statuses, assignees, or date filters)
+- Pagination parameters (page, order_by, reverse) alone are not considered filters
+
+Notes:
+- Provides workspace-wide task access (unlike get_tasks which only searches in one list)
+- Returns complete task details including descriptions, assignees, custom fields, and all metadata
+- Tag filtering is especially useful for cross-list organization (e.g., "project-x", "blocker", "needs-review")
+- Combine multiple filters to narrow down your search scope
+- Use pagination for large result sets
+- Use the detail_level parameter to control the amount of data returned:
+  - "summary": Returns lightweight task data (name, status, list, tags)
+  - "detailed": Returns complete task data with all fields (DEFAULT if not specified)
+- Responses exceeding 50,000 tokens automatically switch to summary format to avoid hitting LLM token limits
+`,
+    parameters: {
+        type: 'object',
+        properties: {
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by tag names. Only tasks with ALL specified tags will be returned.'
+            },
+            list_ids: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by list IDs. Narrows the search to specific lists.'
+            },
+            folder_ids: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by folder IDs. Narrows the search to specific folders.'
+            },
+            space_ids: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by space IDs. Narrows the search to specific spaces.'
+            },
+            statuses: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by status names (e.g., [\'To Do\', \'In Progress\']).'
+            },
+            assignees: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by assignee IDs.'
+            },
+            date_created_gt: {
+                type: 'number',
+                description: 'Filter for tasks created after this timestamp.'
+            },
+            date_created_lt: {
+                type: 'number',
+                description: 'Filter for tasks created before this timestamp.'
+            },
+            date_updated_gt: {
+                type: 'number',
+                description: 'Filter for tasks updated after this timestamp.'
+            },
+            date_updated_lt: {
+                type: 'number',
+                description: 'Filter for tasks updated before this timestamp.'
+            },
+            due_date_gt: {
+                type: 'number',
+                description: 'Filter for tasks with due date greater than this timestamp.'
+            },
+            due_date_lt: {
+                type: 'number',
+                description: 'Filter for tasks with due date less than this timestamp.'
+            },
+            include_closed: {
+                type: 'boolean',
+                description: 'Include closed tasks in the results.'
+            },
+            include_archived_lists: {
+                type: 'boolean',
+                description: 'Include tasks from archived lists.'
+            },
+            include_closed_lists: {
+                type: 'boolean',
+                description: 'Include tasks from closed lists.'
+            },
+            archived: {
+                type: 'boolean',
+                description: 'Include archived tasks in the results.'
+            },
+            order_by: {
+                type: 'string',
+                enum: ['id', 'created', 'updated', 'due_date'],
+                description: 'Sort field for ordering results.'
+            },
+            reverse: {
+                type: 'boolean',
+                description: 'Reverse sort order (descending).'
+            },
+            page: {
+                type: 'number',
+                description: 'Page number for pagination (0-based).'
+            },
+            detail_level: {
+                type: 'string',
+                enum: ['summary', 'detailed'],
+                description: 'Level of detail to return. Use summary for lightweight responses or detailed for full task data. If not specified, defaults to "detailed".'
+            }
+        }
+    },
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by tag names. Only tasks with ALL specified tags will be returned.'
+            },
+            list_ids: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by list IDs. Narrows the search to specific lists.'
+            },
+            folder_ids: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by folder IDs. Narrows the search to specific folders.'
+            },
+            space_ids: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by space IDs. Narrows the search to specific spaces.'
+            },
+            statuses: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by status names (e.g., [\'To Do\', \'In Progress\']).'
+            },
+            assignees: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filter tasks by assignee IDs.'
+            },
+            date_created_gt: {
+                type: 'number',
+                description: 'Filter for tasks created after this timestamp.'
+            },
+            date_created_lt: {
+                type: 'number',
+                description: 'Filter for tasks created before this timestamp.'
+            },
+            date_updated_gt: {
+                type: 'number',
+                description: 'Filter for tasks updated after this timestamp.'
+            },
+            date_updated_lt: {
+                type: 'number',
+                description: 'Filter for tasks updated before this timestamp.'
+            },
+            due_date_gt: {
+                type: 'number',
+                description: 'Filter for tasks with due date greater than this timestamp.'
+            },
+            due_date_lt: {
+                type: 'number',
+                description: 'Filter for tasks with due date less than this timestamp.'
+            },
+            include_closed: {
+                type: 'boolean',
+                description: 'Include closed tasks in the results.'
+            },
+            include_archived_lists: {
+                type: 'boolean',
+                description: 'Include tasks from archived lists.'
+            },
+            include_closed_lists: {
+                type: 'boolean',
+                description: 'Include tasks from closed lists.'
+            },
+            archived: {
+                type: 'boolean',
+                description: 'Include archived tasks in the results.'
+            },
+            order_by: {
+                type: 'string',
+                enum: ['id', 'created', 'updated', 'due_date'],
+                description: 'Sort field for ordering results.'
+            },
+            reverse: {
+                type: 'boolean',
+                description: 'Reverse sort order (descending).'
+            },
+            page: {
+                type: 'number',
+                description: 'Page number for pagination (0-based).'
+            },
+            detail_level: {
+                type: 'string',
+                enum: ['summary', 'detailed'],
+                description: 'Level of detail to return. Use summary for lightweight responses or detailed for full task data. If not specified, defaults to "detailed".'
+            }
+        }
+    }
+};