@taazkareem/clickup-mcp-server 0.6.6 → 0.6.7

package/README.md

@@ -1,12 +1,12 @@
 <img src="assets/images/clickup_mcp_server_social_image.png" alt="ClickUp MCP Server" width="100%">
 
-![Total Supporters](https://img.shields.io/badge/🏆%20Total%20Supporters-2-gold)
+![Total Supporters](https://img.shields.io/badge/🏆%20Total%20Supporters-3-gold)
 [![GitHub Stars](https://img.shields.io/github/stars/TaazKareem/clickup-mcp-server?style=flat&logo=github)](https://github.com/TaazKareem/clickup-mcp-server/stargazers)
 [![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-brightgreen.svg)](https://github.com/TaazKareem/clickup-mcp-server/graphs/commit-activity)
 
 A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.
 
-> 🚧 **Status Update:** Rolling out v0.6.5 will add Global Task Lookup with smart disambiguation, Start Date Support for tasks with natural language expressions, Complete Tag Support including natural language tag color commands, Subtasks Support, Custom ID Support, and Logging Fixes
+> 🚧 **Status Update:** Rolling out v0.6.6 will add Global Task Lookup with smart disambiguation, Start Date Support for tasks with natural language expressions, Complete Tag Support including natural language tag color commands, Subtasks Support, Custom ID Support, and Logging Fixes
 
 ## Setup
 
@@ -20,7 +20,7 @@ A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI appl
 
 [![smithery badge](https://smithery.ai/badge/@taazkareem/clickup-mcp-server)](https://smithery.ai/server/@TaazKareem/clickup-mcp-server)
 
-The server is hosted on [Smithery](https://smithery.ai/server/@TaazKareem/clickup-mcp-server). There, you can preview the available tools or copy the commands to run on your specific client app. 
+The server is hosted on [Smithery](https://smithery.ai/server/@taazkareem/clickup-mcp-server). There, you can preview the available tools or copy the commands to run on your specific client app. 
 
 ## NPX Installation
 

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

@@ -22,22 +22,11 @@ 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 if available)
-2. Provide spaceName (will be resolved to a space ID)
-
-Requirements:
-- EITHER spaceId OR spaceName is REQUIRED
-
-Notes:
-- Tags are defined at the space level in ClickUp
-- You need to know the available tags before adding them to tasks`,
+    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: {
@@ -200,26 +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 (optionally with listName for disambiguation)
-
-Requirements:
-- tagName: REQUIRED
-- EITHER taskId OR customTaskId OR taskName: 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
-- If multiple tasks have the same name, provide listName to disambiguate
-
-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: {
@@ -252,20 +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 (optionally with listName for disambiguation)
-
-Requirements:
-- tagName: REQUIRED
-- EITHER taskId OR customTaskId OR taskName: REQUIRED
-
-Notes:
-- This only removes the association between the tag and task
-- The tag will still exist in the space
-- If multiple tasks have the same name, provide listName to disambiguate`,
+    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: {

package/build/tools/task/attachments.js

@@ -33,42 +33,7 @@ setInterval(() => {
  */
 export const attachTaskFileTool = {
     name: "attach_task_file",
-    description: `Purpose: Attaches a file to a ClickUp task.
-
-Valid Usage:
-1. Use taskId alone (preferred) - works with both regular and custom IDs
-2. Use taskName alone (will search across all lists)
-3. Use taskName + listName (for faster, targeted search)
-
-File Source Options:
-1. Upload from base64: Provide file_data + file_name
-2. Upload from URL: Provide file_url starting with http:// or https://
-3. Upload from local file: Provide file_url as absolute path (starting with / or drive letter)
-4. For large files: Use chunk_* parameters for advanced chunked uploading
-
-Requirements:
-- EITHER taskId OR taskName: REQUIRED
-- listName: Optional, but recommended when using taskName
-- File Source: ONE of the following is REQUIRED:
-  - file_data + file_name
-  - file_url (web URL or local path)
-  - chunk_session (for continuing chunked upload)
-
-Notes:
-- The tool automatically searches for tasks using smart name matching
-- When only taskName is provided, it searches across all lists
-- Adding listName narrows the search to a specific list for better performance
-- The system automatically selects the best upload method based on file size and source:
-  - Base64 method: Limited to 10MB due to encoding overhead
-  - URL method: Works for files hosted online
-  - Local file method: Works with absolute paths only
-  - Large files: Automatically uses chunked uploading
-
-Warning:
-- Using taskName without listName may match multiple tasks
-- If multiple matches are found, the operation will fail with a disambiguation error
-- For local files, relative paths are not supported
-- Base64 uploads over 10MB will automatically switch to chunked upload mode`,
+    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: {

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

@@ -73,21 +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)
-- EITHER listId OR listName: REQUIRED
-- All tasks will be created in the specified list
-
-Notes:
-- Configure batch size and concurrency via options for performance
-- Each task should have a name with emoji prefix
-- Custom fields can be set for each task using the custom_fields property (array of {id, value} objects)`,
+    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: {
@@ -163,29 +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. For each task, provide taskId (preferred)
-2. For each task, provide taskName + listName
-
-Requirements:
-- tasks: REQUIRED (array of tasks to update)
-- For each task entry, EITHER taskId OR (taskName + listName) is REQUIRED
-- At least one update field per task (name, description, status, priority, dueDate)
-
-Notes:
-- Only specified fields will be updated for each task
-- Configure batch size and concurrency via options for performance
-- Each task can have different fields to update
-- Custom fields can be updated using the custom_fields property (array of {id, value} objects)
-
-Warning:
-- Using taskName without listName will fail as tasks may have identical names across lists`,
+    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: {
@@ -262,28 +230,11 @@ Warning:
     }
 };
 /**
- * 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. For each task, provide taskId + target list (preferred)
-2. For each task, provide taskName + listName + target list
-
-Requirements:
-- tasks: REQUIRED (array of tasks to move)
-- EITHER targetListId OR targetListName: REQUIRED
-- For each task entry, EITHER taskId OR (taskName + listName) is REQUIRED
-
-Notes:
-- Configure batch size and concurrency via options for performance
-- All tasks will be moved to the same destination list
-
-Warning:
-- Task statuses may reset if destination list has different status options
-- Using taskName without listName will fail as tasks may have identical names across lists`,
+    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: {
@@ -326,27 +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. For each task, provide taskId (preferred and safest)
-2. For each task, provide taskName + listName
-
-Requirements:
-- tasks: REQUIRED (array of tasks to delete)
-- For each task entry, EITHER taskId OR (taskName + listName) is REQUIRED
-
-Notes:
-- Configure batch size and concurrency via options for performance
-
-Warning:
-- This action CANNOT be undone for any of the tasks
-- Using taskName without listName is dangerous as names may not be unique
-- Always provide listName when using taskName for safer targeting`,
+    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: {

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

@@ -48,21 +48,7 @@ const handleOperationError = (operation, error) => {
  */
 export const createTaskTool = {
     name: "create_task",
-    description: `Purpose: Create a single task in a ClickUp list.
-
-Valid Usage:
-1. Provide listId (preferred if available)
-2. Provide listName (system will look up the list ID)
-
-Requirements:
-- name: REQUIRED
-- EITHER listId OR listName: REQUIRED
-
-Notes:
-- For multiple tasks, use create_bulk_tasks instead
-- 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
-- Custom fields can be set using the custom_fields parameter (array of {id, value} objects)`,
+    description: `Creates a single task in a ClickUp list. Use listId (preferred) or listName. Required: name + list info. For multiple tasks use create_bulk_tasks. Can create subtasks via parent param. Supports custom fields as array of {id, value}.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -142,28 +128,7 @@ Notes:
  */
 export const updateTaskTool = {
     name: "update_task",
-    description: `Purpose: Modify properties of an existing task.
-
-Valid Usage:
-1. Use taskId alone (preferred) - works with both regular and custom IDs
-2. Use taskName alone (will search across all lists)
-3. Use taskName + listName (for faster, targeted search)
-
-Requirements:
-- At least one update field (name, description, status, priority, dueDate) must be provided
-- EITHER taskId OR taskName: REQUIRED
-- listName: Optional, but recommended when using taskName
-
-Notes:
-- The tool automatically searches for tasks using smart name matching
-- When only taskName is provided, it searches across all lists
-- Adding listName narrows the search to a specific list for better performance
-- Only specified fields will be updated
-- Custom fields can be set using the custom_fields parameter (array of {id, value} objects)
-
-Warning:
-- Using taskName without listName may match multiple tasks
-- If multiple matches are found, the operation will fail with a disambiguation error`,
+    description: `Updates task properties. Use taskId (preferred) or taskName + optional listName. At least one update field required. Custom fields supported as array of {id, value}. WARNING: Using taskName without listName may match multiple tasks.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -233,19 +198,7 @@ Warning:
  */
 export const moveTaskTool = {
     name: "move_task",
-    description: `Purpose: Move a task to a different list.
-
-Valid Usage:
-1. Use taskId + (listId OR listName) - preferred
-2. Use taskName + sourceListName + (listId OR listName)
-
-Requirements:
-- Destination list: EITHER listId OR listName REQUIRED
-- When using taskName, sourceListName is REQUIRED
-
-Warning:
-- Task statuses may reset if destination list has different status options
-- System cannot find a task by name without knowing which list to search in`,
+    description: `Moves task to different list. Use taskId + (listId/listName) preferred, or taskName + sourceListName + (listId/listName). WARNING: Task statuses may reset if destination list has different status options.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -278,21 +231,7 @@ Warning:
  */
 export const duplicateTaskTool = {
     name: "duplicate_task",
-    description: `Purpose: Create a copy of a task in the same or different list.
-
-Valid Usage:
-1. Use taskId + optional (listId OR listName) - preferred
-2. Use taskName + sourceListName + optional (listId OR listName)
-
-Requirements:
-- When using taskName, sourceListName is REQUIRED
-
-Notes:
-- The duplicate preserves the original task's properties
-- If no destination list specified, uses same list as original task
-
-Warning:
-- System cannot find a task by name without knowing which list to search in`,
+    description: `Creates copy of task in same/different list. Use taskId + optional (listId/listName), or taskName + sourceListName + optional (listId/listName). Preserves original properties. Default: same list as original.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -321,28 +260,11 @@ Warning:
     }
 };
 /**
- * Tool definition for retrieving a task
+ * Tool definition for retrieving task details
  */
 export const getTaskTool = {
     name: "get_task",
-    description: `Purpose: Retrieve detailed information about a specific task.
-
-Valid Usage:
-1. Use taskId alone (preferred) - works with both regular and custom IDs (like "DEV-1234")
-2. Use taskName alone (will search across all lists in the workspace)
-3. Use taskName + listName (for faster, targeted search)
-4. Use customTaskId for explicit custom ID lookup
-
-Requirements:
-- EITHER taskId OR taskName OR customTaskId: REQUIRED
-- listName: Optional, but recommended when using taskName for faster and more precise lookup
-
-Note:
-- When using just taskName, the system performs a global search across all lists
-- Task names are most unique within a specific list, so providing listName increases reliability
-- 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")
-- Set subtasks=true to include all subtasks in the response`,
+    description: `Gets task details by taskId (works with regular/custom IDs) or taskName. For taskName search, provide listName for faster lookup. Set subtasks=true to include all subtask details.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -432,16 +354,7 @@ Notes:
  */
 export const getTaskCommentsTool = {
     name: "get_task_comments",
-    description: `Purpose: Retrieve comments for a ClickUp task.
-
-Valid Usage:
-1. Use taskId (preferred)
-2. Use taskName + optional listName
-
-Notes:
-- If using taskName, providing listName helps locate the correct task
-- Task names may not be unique across different lists
-- Use start and startId parameters for pagination through comments`,
+    description: `Gets task comments. Use taskId (preferred) or taskName + optional listName. Use start/startId params for pagination. Task names may not be unique across lists.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -473,20 +386,7 @@ Notes:
  */
 export const createTaskCommentTool = {
     name: "create_task_comment",
-    description: `Purpose: Create a comment on a ClickUp task.
-
-Valid Usage:
-1. Use taskId (preferred)
-2. Use taskName + listName
-
-Requirements:
-- EITHER taskId OR (taskName + listName) is REQUIRED
-- commentText is REQUIRED
-
-Notes:
-- When using taskName, providing listName helps locate the correct task
-- Set notifyAll to true to send notifications to all task assignees
-- Use assignee to assign the comment to a specific user (optional)`,
+    description: `Creates task comment. Use taskId (preferred) or taskName + listName. Required: commentText. Optional: notifyAll to notify assignees, assignee to assign comment.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -523,27 +423,7 @@ Notes:
  */
 export const deleteTaskTool = {
     name: "delete_task",
-    description: `Purpose: PERMANENTLY DELETE a task.
-
-Valid Usage:
-1. Use taskId alone (preferred and safest)
-2. Use taskName alone (will search across all lists)
-3. Use taskName + listName (for faster, targeted search)
-
-Requirements:
-- EITHER taskId OR taskName: REQUIRED
-- listName: Optional, but recommended when using taskName
-
-Notes:
-- The tool automatically searches for tasks using smart name matching
-- When only taskName is provided, it searches across all lists
-- Adding listName narrows the search to a specific list for better performance
-- Supports both regular task IDs and custom IDs (like 'DEV-1234')
-
-Warning:
-- This action CANNOT be undone
-- Using taskName without listName may match multiple tasks
-- If multiple matches are found, the operation will fail with a disambiguation error`,
+    description: `PERMANENTLY deletes task. Use taskId (preferred/safest) or taskName + optional listName. WARNING: Cannot be undone. Using taskName without listName may match multiple tasks.`,
     inputSchema: {
         type: "object",
         properties: {

package/build/tools/workspace.js

@@ -19,18 +19,7 @@ const { workspace: workspaceService } = clickUpServices;
  */
 export const workspaceHierarchyTool = {
     name: 'get_workspace_hierarchy',
-    description: `Purpose: Retrieve the complete workspace hierarchy including spaces, folders, and lists.
-
-Valid Usage:
-1. Call without parameters to get the full hierarchy
-
-Requirements:
-- No parameters required
-
-Notes:
-- Returns a tree structure showing all spaces, folders, and lists
-- Each item includes its name and ID
-- Use this to navigate the workspace and understand its organization`,
+    description: `Gets complete workspace hierarchy (spaces, folders, lists). No parameters needed. Returns tree structure with names and IDs for navigation.`,
     inputSchema: {
         type: 'object',
         properties: {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taazkareem/clickup-mcp-server",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",