@taazkareem/clickup-mcp-server 0.6.5 → 0.6.7

package/build/tools/folder.js

@@ -16,19 +16,7 @@ const { folder: folderService, workspace: workspaceService } = clickUpServices;
  */
 export const createFolderTool = {
     name: "create_folder",
-    description: `Purpose: Create a new folder in a ClickUp space for organizing related lists.
-
-Valid Usage:
-1. Provide spaceId (preferred) + folder name
-2. Provide spaceName + folder name
-
-Requirements:
-- name: REQUIRED
-- EITHER spaceId OR spaceName: REQUIRED
-
-Notes:
-- After creating a folder, you can add lists to it using create_list_in_folder
-- Use override_statuses to set folder-specific statuses`,
+    description: `Creates folder in ClickUp space. Use spaceId (preferred) or spaceName + folder name. Optional: override_statuses for folder-specific statuses. Use create_list_in_folder to add lists after creation.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -53,22 +41,11 @@ Notes:
     }
 };
 /**
- * Tool definition for getting folder details
+ * Tool definition for retrieving folder details
  */
 export const getFolderTool = {
     name: "get_folder",
-    description: `Purpose: Retrieve details about a specific folder including name, status, and metadata.
-
-Valid Usage:
-1. Use folderId alone (preferred)
-2. Use folderName + (spaceId or spaceName)
-
-Requirements:
-- EITHER folderId OR (folderName + space information) is REQUIRED
-- When using folderName, you MUST provide EITHER spaceId OR spaceName
-
-Notes:
-- Helps you understand folder structure before creating or updating lists`,
+    description: `Gets folder details. Use folderId (preferred) or folderName + (spaceId/spaceName). Helps understand folder structure before creating/updating lists.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -97,19 +74,7 @@ Notes:
  */
 export const updateFolderTool = {
     name: "update_folder",
-    description: `Purpose: Modify an existing folder's properties.
-
-Valid Usage:
-1. Use folderId alone (preferred)
-2. Use folderName + (spaceId or spaceName)
-
-Requirements:
-- At least one update field (name or override_statuses) must be provided
-- EITHER folderId OR (folderName + space information) is REQUIRED
-- When using folderName, you MUST provide EITHER spaceId OR spaceName
-
-Notes:
-- Changes apply immediately to all lists within the folder`,
+    description: `Updates folder properties. Use folderId (preferred) or folderName + (spaceId/spaceName). At least one update field (name/override_statuses) required. Changes apply to all lists in folder.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -146,20 +111,7 @@ Notes:
  */
 export const deleteFolderTool = {
     name: "delete_folder",
-    description: `Purpose: PERMANENTLY DELETE a folder and all its contents.
-
-Valid Usage:
-1. Use folderId alone (preferred and safest)
-2. Use folderName + (spaceId or spaceName)
-
-Requirements:
-- EITHER folderId OR (folderName + space information) is REQUIRED
-- When using folderName, you MUST provide EITHER spaceId OR spaceName
-
-Warning:
-- This action CANNOT be undone
-- All lists and tasks within the folder will also be permanently deleted
-- Using folderName is risky as names may not be unique across different spaces`,
+    description: `PERMANENTLY deletes folder and all contents. Use folderId (preferred/safest) or folderName + (spaceId/spaceName). WARNING: Cannot be undone, all lists/tasks deleted, folderName risky if not unique.`,
     inputSchema: {
         type: "object",
         properties: {

package/build/tools/list.js

@@ -16,19 +16,7 @@ import { sponsorService } from '../utils/sponsor-service.js';
  */
 export const createListTool = {
     name: "create_list",
-    description: `Purpose: Create a new list directly in a ClickUp space (not in a folder).
-
-Valid Usage:
-1. Provide spaceId + list name (preferred)
-2. Provide spaceName + list name
-
-Requirements:
-- name: REQUIRED
-- EITHER spaceId OR spaceName: REQUIRED
-
-Notes:
-- For creating lists inside folders, use create_list_in_folder instead
-- Optional fields include content, dueDate, priority, assignee, and status`,
+    description: `Creates a list in a ClickUp space. Use spaceId (preferred) or spaceName + list name. Name is required. For lists in folders, use create_list_in_folder. Optional: content, dueDate, priority, assignee, status.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -73,21 +61,7 @@ Notes:
  */
 export const createListInFolderTool = {
     name: "create_list_in_folder",
-    description: `Purpose: Create a new list within a ClickUp folder.
-
-Valid Usage:
-1. Provide folderId + list name (preferred)
-2. Provide folderName + (spaceId OR spaceName) + list name
-
-Requirements:
-- name: REQUIRED
-- EITHER folderId OR (folderName + space information): REQUIRED
-- When using folderName, EITHER spaceId OR spaceName is REQUIRED
-
-Notes:
-- Folder names may not be unique across spaces, which is why space information
-  is required when using folderName
-- Optional fields include content and status`,
+    description: `Creates a list in a ClickUp folder. Use folderId (preferred) or folderName + space info + list name. Name is required. When using folderName, spaceId/spaceName required as folder names may not be unique. Optional: content, status.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -128,18 +102,7 @@ Notes:
  */
 export const getListTool = {
     name: "get_list",
-    description: `Purpose: Retrieve details about a specific ClickUp list.
-
-Valid Usage:
-1. Provide listId (preferred)
-2. Provide listName
-
-Requirements:
-- EITHER listId OR listName: REQUIRED
-
-Notes:
-- Using listId is more reliable as list names might not be unique
-- Returns list details including name, content, and space information`,
+    description: `Gets details of a ClickUp list. Use listId (preferred) or listName. Returns list details including name, content, and space info. ListId more reliable as names may not be unique.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -160,19 +123,7 @@ Notes:
  */
 export const updateListTool = {
     name: "update_list",
-    description: `Purpose: Update an existing ClickUp list's properties.
-
-Valid Usage:
-1. Provide listId + update fields (preferred)
-2. Provide listName + update fields
-
-Requirements:
-- EITHER listId OR listName: REQUIRED
-- At least one field to update (name, content, or status): REQUIRED
-
-Notes:
-- Using listId is more reliable as list names might not be unique
-- Only specified fields will be updated`,
+    description: `Updates a ClickUp list. Use listId (preferred) or listName + at least one update field (name/content/status). ListId more reliable as names may not be unique. Only specified fields updated.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -205,19 +156,7 @@ Notes:
  */
 export const deleteListTool = {
     name: "delete_list",
-    description: `Purpose: Permanently delete a ClickUp list and all its tasks.
-
-Valid Usage:
-1. Provide listId (preferred and safest)
-2. Provide listName
-
-Requirements:
-- EITHER listId OR listName: REQUIRED
-
-Warning:
-- This action CANNOT be undone
-- All tasks within the list will also be permanently deleted
-- Using listName is risky as names may not be unique`,
+    description: `PERMANENTLY deletes a ClickUp list and all its tasks. Use listId (preferred/safest) or listName. WARNING: Cannot be undone, all tasks will be deleted, listName risky if not unique.`,
     inputSchema: {
         type: "object",
         properties: {

package/build/tools/tag.js

@@ -13,24 +13,20 @@ import { clickUpServices } from '../services/shared.js';
 import { Logger } from '../logger.js';
 import { sponsorService } from '../utils/sponsor-service.js';
 import { processColorCommand } from '../utils/color-processor.js';
+import { validateTaskIdentification } from './task/utilities.js';
 // Create a logger specific to tag tools
 const logger = new Logger('TagTools');
+// Use shared services instance
+const { task: taskService } = clickUpServices;
 //=============================================================================
 // TOOL DEFINITIONS
 //=============================================================================
 /**
- * Tool definition for getting tags in a space
+ * Tool definition for getting space tags
  */
 export const getSpaceTagsTool = {
     name: "get_space_tags",
-    description: `Purpose: Get all tags available in a ClickUp space.
-
-Valid Usage:
-1. Provide spaceId (preferred)
-2. Provide spaceName
-
-Requirements:
-- Space identification: EITHER spaceId OR spaceName REQUIRED`,
+    description: `Gets all tags in a ClickUp space. Use spaceId (preferred) or spaceName. Tags are defined at space level - check available tags before adding to tasks.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -53,15 +49,18 @@ export const createSpaceTagTool = {
     description: `Purpose: Create a new tag in a ClickUp space.
 
 Valid Usage:
-1. Provide spaceId + tagName (preferred)
-2. Provide spaceName + tagName
+1. Provide spaceId (preferred if available)
+2. Provide spaceName (will be resolved to a space ID)
 
 Requirements:
 - tagName: REQUIRED
-- Space identification: EITHER spaceId OR spaceName REQUIRED
+- EITHER spaceId OR spaceName: REQUIRED
 
 Notes:
-- Specify colors with HEX values or natural language command`,
+- New tag will be available for all tasks in the space
+- You can specify background and foreground colors in HEX format (e.g., #FF0000)
+- You can also provide a color command (e.g., "blue tag") to automatically generate colors
+- After creating a tag, you can add it to tasks using add_tag_to_task`,
     inputSchema: {
         type: "object",
         properties: {
@@ -190,25 +189,7 @@ Warning:
  */
 export const addTagToTaskTool = {
     name: "add_tag_to_task",
-    description: `Purpose: Add an existing tag to a ClickUp task.
-
-Valid Usage:
-1. Provide taskId (preferred if available)
-2. Provide taskName + listName
-
-Requirements:
-- tagName: REQUIRED
-- EITHER taskId OR (taskName + listName): REQUIRED
-- The tag MUST exist in the space containing the task before calling this tool
-
-Warning:
-- The operation will fail if the tag does not exist in the space
-- Always use get_space_tags first to verify the tag exists
-- If the tag doesn't exist, create it using create_space_tag before adding it to the task
-
-Notes:
-- Use get_space_tags to see available tags
-- Use create_space_tag to create a new tag if needed`,
+    description: `Adds existing tag to task. Use taskId (preferred) or taskName + optional listName. Tag must exist in space (use get_space_tags to verify, create_space_tag if needed). WARNING: Will fail if tag doesn't exist.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -222,11 +203,11 @@ Notes:
             },
             taskName: {
                 type: "string",
-                description: "Name of the task to add tag to. When using this parameter, you MUST also provide listName."
+                description: "Name of the task to add tag to. Will search across all lists unless listName is provided."
             },
             listName: {
                 type: "string",
-                description: "Name of the list containing the task. REQUIRED when using taskName."
+                description: "Optional: Name of the list containing the task. Use to disambiguate when multiple tasks have the same name."
             },
             tagName: {
                 type: "string",
@@ -241,19 +222,7 @@ Notes:
  */
 export const removeTagFromTaskTool = {
     name: "remove_tag_from_task",
-    description: `Purpose: Remove a tag from a ClickUp task.
-
-Valid Usage:
-1. Provide taskId (preferred if available)
-2. Provide taskName + listName
-
-Requirements:
-- tagName: REQUIRED
-- EITHER taskId OR (taskName + listName): REQUIRED
-
-Notes:
-- This only removes the association between the tag and task
-- The tag will still exist in the space`,
+    description: `Removes tag from task. Use taskId (preferred) or taskName + optional listName. Only removes tag-task association, tag remains in space. For multiple tasks, provide listName to disambiguate.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -267,11 +236,11 @@ Notes:
             },
             taskName: {
                 type: "string",
-                description: "Name of the task to remove tag from. When using this parameter, you MUST also provide listName."
+                description: "Name of the task to remove tag from. Will search across all lists unless listName is provided."
             },
             listName: {
                 type: "string",
-                description: "Name of the list containing the task. REQUIRED when using taskName."
+                description: "Optional: Name of the list containing the task. Use to disambiguate when multiple tasks have the same name."
             },
             tagName: {
                 type: "string",
@@ -334,10 +303,18 @@ export const handleDeleteSpaceTag = createHandlerWrapper(deleteSpaceTag, () => (
 /**
  * Wrapper for addTagToTask handler
  */
-export const handleAddTagToTask = createHandlerWrapper(addTagToTask, () => ({
-    success: true,
-    message: "Tag added to task successfully"
-}));
+export const handleAddTagToTask = createHandlerWrapper(addTagToTask, (result) => {
+    if (!result.success) {
+        return {
+            success: false,
+            error: result.error
+        };
+    }
+    return {
+        success: true,
+        message: "Tag added to task successfully"
+    };
+});
 /**
  * Wrapper for removeTagFromTask handler
  */
@@ -666,28 +643,42 @@ export async function deleteSpaceTag(params) {
  */
 async function resolveTaskId(params) {
     const { taskId, customTaskId, taskName, listName } = params;
-    // If we have a direct taskId, use it
-    if (taskId) {
-        return { success: true, taskId };
-    }
-    // Custom task ID handling
-    if (customTaskId) {
-        return { success: true, taskId: customTaskId };
+    try {
+        // First validate task identification with global lookup enabled
+        const validationResult = validateTaskIdentification({ taskId, customTaskId, taskName, listName }, { useGlobalLookup: true });
+        if (!validationResult.isValid) {
+            return {
+                success: false,
+                error: { message: validationResult.errorMessage }
+            };
+        }
+        const result = await taskService.findTasks({
+            taskId,
+            customTaskId,
+            taskName,
+            listName,
+            allowMultipleMatches: false,
+            useSmartDisambiguation: true,
+            includeFullDetails: false
+        });
+        if (!result || Array.isArray(result)) {
+            return {
+                success: false,
+                error: { message: 'Task not found with the provided identification' }
+            };
+        }
+        return { success: true, taskId: result.id };
     }
-    // Task name lookup (requires list name)
-    if (taskName && listName) {
-        // Implementation would go here
+    catch (error) {
         return {
             success: false,
-            error: { message: 'Task name resolution not implemented yet' }
+            error: {
+                message: error.message || 'Failed to resolve task ID',
+                code: error.code,
+                details: error.data
+            }
         };
     }
-    return {
-        success: false,
-        error: {
-            message: 'Task identifier is required (taskId, customTaskId, or taskName+listName)'
-        }
-    };
 }
 /**
  * Add a tag to a task
@@ -705,12 +696,12 @@ export async function addTagToTask(params) {
             }
         };
     }
-    if (!taskId && !customTaskId && !(taskName && listName)) {
-        logger.error('addTagToTask called without proper task identifier');
+    if (!taskId && !customTaskId && !taskName) {
+        logger.error('addTagToTask called without task identifier');
         return {
             success: false,
             error: {
-                message: 'Either taskId, customTaskId, or both taskName and listName are required'
+                message: 'Either taskId, customTaskId, or taskName is required'
             }
         };
     }
@@ -728,6 +719,31 @@ export async function addTagToTask(params) {
         const result = await clickUpServices.tag.addTagToTask(taskIdResult.taskId, tagName);
         if (!result.success) {
             logger.error('Failed to add tag to task', result.error);
+            // Provide more specific error messages based on error code
+            if (result.error?.code === 'TAG_NOT_FOUND') {
+                return {
+                    success: false,
+                    error: {
+                        message: `The tag "${tagName}" does not exist in the space. Please create it first using create_space_tag.`
+                    }
+                };
+            }
+            else if (result.error?.code === 'SPACE_NOT_FOUND') {
+                return {
+                    success: false,
+                    error: {
+                        message: 'Could not determine which space the task belongs to.'
+                    }
+                };
+            }
+            else if (result.error?.code === 'TAG_VERIFICATION_FAILED') {
+                return {
+                    success: false,
+                    error: {
+                        message: 'The tag addition could not be verified. Please check if the tag was added manually.'
+                    }
+                };
+            }
             return {
                 success: false,
                 error: result.error || {
@@ -768,12 +784,12 @@ export async function removeTagFromTask(params) {
             }
         };
     }
-    if (!taskId && !customTaskId && !(taskName && listName)) {
-        logger.error('removeTagFromTask called without proper task identifier');
+    if (!taskId && !customTaskId && !taskName) {
+        logger.error('removeTagFromTask called without task identifier');
         return {
             success: false,
             error: {
-                message: 'Either taskId, customTaskId, or both taskName and listName are required'
+                message: 'Either taskId, customTaskId, or taskName is required'
             }
         };
     }

package/build/tools/task/attachments.js

@@ -10,8 +10,11 @@
 import { clickUpServices } from '../../services/shared.js';
 import { validateTaskIdentification } from './utilities.js';
 import { sponsorService } from '../../utils/sponsor-service.js';
+import { Logger } from '../../logger.js';
 // Use shared services instance
 const { task: taskService } = clickUpServices;
+// Create a logger instance for attachments
+const logger = new Logger('TaskAttachments');
 // Session storage for chunked uploads (in-memory for demonstration)
 const chunkSessions = new Map();
 // Clean up expired sessions periodically
@@ -21,7 +24,7 @@ setInterval(() => {
     for (const [token, session] of chunkSessions.entries()) {
         if (now - session.timestamp > expired) {
             chunkSessions.delete(token);
-            console.log(`Cleaned up expired upload session: ${token}`);
+            logger.debug(`Cleaned up expired upload session: ${token}`);
         }
     }
 }, 3600 * 1000); // Check every hour
@@ -30,26 +33,7 @@ setInterval(() => {
  */
 export const attachTaskFileTool = {
     name: "attach_task_file",
-    description: `Purpose: Attaches a file to a ClickUp task.
-
-Valid Usage:
-1. Use taskId (preferred) - works with both regular and custom IDs
-2. Use taskName + listName for targeted search
-
-File Sources:
-- Base64: Provide file_data + file_name
-- URL: Provide file_url starting with http:// or https://
-- Local file: Provide file_url as absolute path
-- Chunked upload: Use chunk_* parameters for large files
-
-Requirements:
-- Task identification: EITHER taskId OR taskName REQUIRED
-- File source: EITHER file_data+file_name OR file_url OR chunk_session REQUIRED
-
-Notes:
-- System automatically selects best upload method based on file size
-- Base64 uploads limited to 10MB
-- Using taskName without listName may match multiple tasks`,
+    description: `Attaches file to task. Use taskId (preferred) or taskName + optional listName. File sources: 1) base64 + filename (≤10MB), 2) URL (http/https), 3) local path (absolute), 4) chunked for large files. WARNING: taskName without listName may match multiple tasks.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -106,9 +90,12 @@ Notes:
  */
 async function attachTaskFileHandler(params) {
     // Extract common parameters
-    const { taskId, taskName, listName, file_name, file_data, file_url, auth_header, chunk_total, chunk_size, chunk_index, session_id } = params;
+    const { taskId, taskName, listName, customTaskId, file_name, file_data, file_url, auth_header, chunk_total, chunk_size, chunk_index, session_id } = params;
     // Validate task identification
-    validateTaskIdentification(params);
+    const validationResult = validateTaskIdentification({ taskId, taskName, listName, customTaskId }, { useGlobalLookup: true });
+    if (!validationResult.isValid) {
+        throw new Error(validationResult.errorMessage);
+    }
     // Validate file source - either file_data or file_url must be provided
     if (!file_data && !file_url && !session_id) {
         throw new Error("Either file_data, file_url, or session_id must be provided");
@@ -134,13 +121,13 @@ async function attachTaskFileHandler(params) {
         // CASE 2: URL-based upload or local file path
         if (file_url) {
             // Check if it's a local file path
-            console.log(`Checking if path is local: ${file_url}`);
+            logger.debug(`Checking if path is local: ${file_url}`);
             if (file_url.startsWith('/') || /^[A-Za-z]:\\/.test(file_url)) {
-                console.log(`Detected as local path, proceeding to handle: ${file_url}`);
+                logger.debug(`Detected as local path, proceeding to handle: ${file_url}`);
                 return await handleLocalFileUpload(resolvedTaskId, file_url, file_name);
             }
             else if (file_url.startsWith('http://') || file_url.startsWith('https://')) {
-                console.log(`Detected as URL, proceeding with URL upload: ${file_url}`);
+                logger.debug(`Detected as URL, proceeding with URL upload: ${file_url}`);
                 return await handleUrlUpload(resolvedTaskId, file_url, file_name, auth_header);
             }
             else {
@@ -167,7 +154,7 @@ async function attachTaskFileHandler(params) {
         throw new Error("Invalid parameters: Unable to determine upload method");
     }
     catch (error) {
-        console.error(`Error attaching file to task:`, error);
+        logger.error(`Error attaching file to task:`, error);
         throw error;
     }
 }
@@ -315,7 +302,7 @@ async function handleLocalFileUpload(taskId, filePath, fileName) {
         // Import fs and path modules
         const fs = await import('fs');
         const path = await import('path');
-        console.log(`Processing absolute file path: ${filePath}`);
+        logger.debug(`Processing absolute file path: ${filePath}`);
         // Normalize the path to prevent directory traversal attacks
         const normalizedPath = path.normalize(filePath);
         // Check if file exists
@@ -332,7 +319,7 @@ async function handleLocalFileUpload(taskId, filePath, fileName) {
         // Read file
         const fileBuffer = fs.readFileSync(normalizedPath);
         const fileSize = fileBuffer.length;
-        console.log(`Successfully read file: ${extractedFileName} (${fileSize} bytes)`);
+        logger.debug(`Successfully read file: ${extractedFileName} (${fileSize} bytes)`);
         // Choose upload method based on file size
         if (fileSize > 10 * 1024 * 1024) {
             // For large files, start chunked upload process

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

@@ -73,19 +73,7 @@ const taskIdentifierSchema = {
  */
 export const createBulkTasksTool = {
     name: "create_bulk_tasks",
-    description: `Purpose: Create multiple tasks in a list efficiently.
-
-Valid Usage:
-1. Provide listId + array of tasks (preferred)
-2. Provide listName + array of tasks
-
-Requirements:
-- tasks: REQUIRED (array of tasks, each with at least a name)
-- List identification: EITHER listId OR listName REQUIRED
-
-Notes:
-- Configure batch processing via options parameter
-- Custom fields supported for each task`,
+    description: `Creates multiple tasks in one list. Use listId (preferred) or listName + array of tasks (each needs name). Configure batch size/concurrency via options. Tasks can have custom fields as {id, value} array.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -161,23 +149,11 @@ Notes:
     }
 };
 /**
- * Tool definition for updating multiple tasks efficiently
+ * Tool definition for updating multiple tasks
  */
 export const updateBulkTasksTool = {
     name: "update_bulk_tasks",
-    description: `Purpose: Update multiple tasks efficiently in a single operation.
-
-Valid Usage:
-1. Provide array of tasks with taskId (preferred)
-2. Provide array of tasks with taskName + listName
-
-Requirements:
-- tasks: REQUIRED (array of tasks to update)
-- Each task needs identification and update fields
-
-Notes:
-- Only specified fields will be updated for each task
-- Configure batch processing via options parameter`,
+    description: `Updates multiple tasks efficiently. For each task: use taskId (preferred) or taskName + listName. At least one update field per task. Configure batch size/concurrency via options. WARNING: taskName without listName will fail.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -254,21 +230,11 @@ Notes:
     }
 };
 /**
- * Tool definition for moving multiple tasks at once
+ * Tool definition for moving multiple tasks
  */
 export const moveBulkTasksTool = {
     name: "move_bulk_tasks",
-    description: `Purpose: Move multiple tasks to a different list efficiently.
-
-Valid Usage:
-1. Provide tasks array + target list
-
-Requirements:
-- tasks: REQUIRED (array of task identifiers)
-- Target list: EITHER targetListId OR targetListName REQUIRED
-
-Warning:
-- Task statuses may reset if destination list has different status options`,
+    description: `Moves multiple tasks to one list. For each task: use taskId (preferred) or taskName + listName. Target list: use targetListId/Name. Configure batch size/concurrency via options. WARNING: Task statuses may reset, taskName needs listName.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -311,22 +277,11 @@ Warning:
     }
 };
 /**
- * Tool definition for deleting multiple tasks at once
+ * Tool definition for deleting multiple tasks
  */
 export const deleteBulkTasksTool = {
     name: "delete_bulk_tasks",
-    description: `Purpose: PERMANENTLY DELETE multiple tasks at once.
-
-Valid Usage:
-1. Provide array of tasks with taskId (preferred)
-2. Provide array of tasks with taskName + listName
-
-Requirements:
-- tasks: REQUIRED (array of task identifiers)
-
-Warning:
-- This action CANNOT be undone
-- Always provide listName when using taskName`,
+    description: `PERMANENTLY deletes multiple tasks. For each task: use taskId (preferred/safest) or taskName + listName. Configure batch size/concurrency via options. WARNING: Cannot be undone, taskName without listName is dangerous.`,
     inputSchema: {
         type: "object",
         properties: {