@taazkareem/clickup-mcp-server 0.5.1 → 0.6.1

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 } = 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
@@ -95,7 +98,9 @@ export async function createTaskHandler(params) {
         markdown_description,
         status,
         priority,
-        due_date: dueDate ? parseDueDate(dueDate) : undefined
+        due_date: dueDate ? parseDueDate(dueDate) : undefined,
+        parent,
+        tags
     });
 }
 /**
@@ -131,6 +136,12 @@ export async function duplicateTaskHandler(params) {
 export async function getTaskHandler(params) {
     // resolveTaskIdWithValidation now auto-detects whether taskId is a regular ID or custom ID
     const taskId = await getTaskId(params.taskId, params.taskName, params.listName, params.customTaskId);
+    // If subtasks parameter is provided and true, use the getTaskWithSubtasks method
+    if (params.subtasks) {
+        const task = await taskService.getTask(taskId);
+        const subtasks = await taskService.getSubtasks(taskId);
+        return { ...task, subtasks };
+    }
     return await taskService.getTask(taskId);
 }
 /**
@@ -140,14 +151,6 @@ 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
  */
@@ -186,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
 //=============================================================================
@@ -242,3 +300,11 @@ export async function deleteBulkTasksHandler(params) {
     await bulkService.deleteTasks(taskIds, parseBulkOptions(params.options));
     return taskIds.map(() => true);
 }
+/**
+ * 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;
+}

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,
@@ -57,7 +60,8 @@ Requirements:
 
 Notes:
 - For multiple tasks, use create_bulk_tasks instead
-- Reuse list IDs from previous responses when possible to avoid redundant lookups`,
+- Reuse list IDs from previous responses when possible to avoid redundant lookups
+- To create a subtask, set the parent parameter to the ID of the parent task`,
     inputSchema: {
         type: "object",
         properties: {
@@ -92,6 +96,17 @@ Notes:
             dueDate: {
                 type: "string",
                 description: "Optional due date. Supports Unix timestamps (ms) or natural language like '1 hour from now', 'tomorrow', 'next week', etc."
+            },
+            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."
             }
         }
     }
@@ -269,7 +284,8 @@ Requirements:
 Note:
 - Task names are only unique within a list, so the system needs to know which list to search in
 - Regular task IDs are always 9 characters long (e.g., "86b394eqa")
-- Custom IDs have an uppercase prefix followed by a hyphen and number (e.g., "DEV-1234")`,
+- Custom IDs have an uppercase prefix followed by a hyphen and number (e.g., "DEV-1234")
+- Set subtasks=true to include all subtasks in the response`,
     inputSchema: {
         type: "object",
         properties: {
@@ -288,6 +304,10 @@ Note:
             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."
+            },
+            subtasks: {
+                type: "boolean",
+                description: "Whether to include subtasks in the response. Set to true to retrieve full details of all subtasks."
             }
         },
         required: []
@@ -322,6 +342,15 @@ Notes:
                 type: "string",
                 description: "Name of list to get tasks from. Only use if you don't have listId."
             },
+            subtasks: {
+                type: "boolean",
+                description: "Include subtasks"
+            },
+            statuses: {
+                type: "array",
+                items: { type: "string" },
+                description: "Filter by status names (e.g. ['To Do', 'In Progress'])"
+            },
             archived: {
                 type: "boolean",
                 description: "Include archived tasks"
@@ -337,55 +366,11 @@ Notes:
             reverse: {
                 type: "boolean",
                 description: "Reverse sort order (descending)"
-            },
-            subtasks: {
-                type: "boolean",
-                description: "Include subtasks"
-            },
-            statuses: {
-                type: "array",
-                items: {
-                    type: "string"
-                },
-                description: "Filter by status names (e.g. ['To Do', 'In Progress'])"
             }
         },
         required: []
     }
 };
-/**
- * Tool definition for deleting a task
- */
-export const deleteTaskTool = {
-    name: "delete_task",
-    description: `Purpose: PERMANENTLY DELETE a task.
-
-Valid Usage:
-1. Use taskId alone (preferred and safest)
-2. Use taskName + optional listName
-
-Warning:
-- This action CANNOT be undone
-- Using taskName is risky as names may not be unique
-- Provide listName when using taskName for more precise targeting`,
-    inputSchema: {
-        type: "object",
-        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')."
-            },
-            taskName: {
-                type: "string",
-                description: "Name of task to delete. Use with extreme caution as names may not be unique."
-            },
-            listName: {
-                type: "string",
-                description: "Name of list containing the task. Helps ensure correct task deletion when using taskName."
-            }
-        }
-    }
-};
 /**
  * Tool definition for retrieving task comments
  */
@@ -477,3 +462,36 @@ Notes:
         required: ["commentText"]
     }
 };
+/**
+ * Tool definition for deleting a task
+ */
+export const deleteTaskTool = {
+    name: "delete_task",
+    description: `Purpose: PERMANENTLY DELETE a task.
+
+Valid Usage:
+1. Use taskId alone (preferred and safest)
+2. Use taskName + optional listName
+
+Warning:
+- This action CANNOT be undone
+- Using taskName is risky as names may not be unique
+- Provide listName when using taskName for more precise targeting`,
+    inputSchema: {
+        type: "object",
+        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')."
+            },
+            taskName: {
+                type: "string",
+                description: "Name of task to delete. Use with extreme caution as names may not be unique."
+            },
+            listName: {
+                type: "string",
+                description: "Name of list containing the task. Helps ensure correct task deletion when using taskName."
+            }
+        }
+    }
+};

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".'
+            }
+        }
+    }
+};

package/build/tools/utils.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * Utility functions for ClickUp MCP tools
  *
  * Re-exports specialized utilities from dedicated modules.