@taazkareem/clickup-mcp-server 0.4.54 → 0.4.57

package/Dockerfile

@@ -31,10 +31,6 @@ COPY --from=builder /app/node_modules ./node_modules
 # Copy the entrypoint script if necessary
 COPY --from=builder /app/package.json ./
 
-# Set environment variables - don't hardcode values
-ENV CLICKUP_API_KEY=""
-ENV CLICKUP_TEAM_ID=""
-
 # Expose the desired port (if the server binds to a port)
 EXPOSE 8080
 

package/README.md

@@ -21,6 +21,9 @@ npx -y @taazkareem/clickup-mcp-server \
 4. Replace the credentials and click Save
 5. Use Natural Language to interact with your ClickUp Workspace!
 
+## Smithery
+[![smithery badge](https://smithery.ai/badge/@TaazKareem/clickup-mcp-server)](https://smithery.ai/server/@TaazKareem/clickup-mcp-server)
+
 ## Features
 
 - 🎯 **Task Management**
@@ -32,9 +35,10 @@ npx -y @taazkareem/clickup-mcp-server \
 - 📂 **Workspace Organization**
   - Complete workspace hierarchy (spaces, folders, lists)
   - Tree structure with clear relationships
-  - Create and manage lists and folders
+  - Full CRUD operations for workspace components
   - Efficient path-based navigation
 
+
 - 🔄 **Integration Features**
   - Name or ID-based item lookup
   - Case-insensitive name matching
@@ -63,6 +67,12 @@ npx -y @taazkareem/clickup-mcp-server \
 | [create_list](docs/api-reference.md#list-management) | Create list in space | `name`, `spaceId`/`spaceName` |
 | [create_folder](docs/api-reference.md#folder-management) | Create folder | `name`, `spaceId`/`spaceName` |
 | [create_list_in_folder](docs/api-reference.md#list-management) | Create list in folder | `name`, `folderId`/`folderName` |
+| [get_folder](docs/api-reference.md#folder-management) | Get folder details | `folderId`/`folderName` |
+| [update_folder](docs/api-reference.md#folder-management) | Update folder properties | `folderId`/`folderName` |
+| [delete_folder](docs/api-reference.md#folder-management) | Delete folder | `folderId`/`folderName` |
+| [get_list](docs/api-reference.md#list-management) | Get list details | `listId`/`listName` |
+| [update_list](docs/api-reference.md#list-management) | Update list properties | `listId`/`listName` |
+| [delete_list](docs/api-reference.md#list-management) | Delete list | `listId`/`listName` |
 
 See [full documentation](docs/api-reference.md) for optional parameters and advanced usage.
 

package/build/index.js

@@ -72,17 +72,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "create_task",
-                description: "Create a single task in a ClickUp list. Use this tool for individual task creation only. For multiple tasks, use create_bulk_tasks instead. The tool finds lists by name (case-insensitive) so explicit list IDs aren't required. When creating a task, you must provide either a listId or listName.",
+                description: "Create a single task in a ClickUp list. Use this tool for individual task creation only. For multiple tasks, use create_bulk_tasks instead. Before calling this tool, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups. When creating a task, you must provide either a listId or listName.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         listId: {
                             type: "string",
-                            description: "ID of the list to create the task in (optional if using listName instead)"
+                            description: "ID of the list to create the task in (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         listName: {
                             type: "string",
-                            description: "Name of the list to create the task in - will automatically find the list by name (optional if using listId instead)"
+                            description: "Name of the list to create the task in - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses."
                         },
                         name: {
                             type: "string",
@@ -109,22 +109,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Due date of the task (Unix timestamp in milliseconds). Convert dates to this format before submitting."
                         }
                     },
-                    required: ["name"]
+                    required: []
                 }
             },
             {
                 name: "create_bulk_tasks",
-                description: "Create multiple tasks in a ClickUp list simultaneously. Use this tool when you need to add several related tasks in one operation. The tool finds lists by name (case-insensitive), so explicit list IDs aren't required. More efficient than creating tasks one by one for batch operations.",
+                description: "Create multiple tasks in a ClickUp list simultaneously. Use this tool when you need to add several related tasks in one operation. Before calling, check if you already have the necessary list ID from previous responses in the conversation, as this avoids redundant lookups. More efficient than creating tasks one by one for batch operations.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         listId: {
                             type: "string",
-                            description: "ID of the list to create the tasks in (optional if using listName instead)"
+                            description: "ID of the list to create the tasks in (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         listName: {
                             type: "string",
-                            description: "Name of the list to create the tasks in - will automatically find the list by name (optional if using listId instead)"
+                            description: "Name of the list to create the tasks in - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses."
                         },
                         tasks: {
                             type: "array",
@@ -164,26 +164,26 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                                         description: "Array of user IDs to assign to the task"
                                     }
                                 },
-                                required: ["name"]
+                                required: []
                             }
                         }
                     },
-                    required: ["listId", "tasks"]
+                    required: []
                 }
             },
             {
                 name: "create_list",
-                description: "Create a new list directly in a ClickUp space. Use this tool when you need a top-level list not nested inside a folder. The tool can find spaces by name, so explicit space IDs aren't required. For creating lists inside folders, use create_list_in_folder instead.",
+                description: "Create a new list directly in a ClickUp space. Use this tool when you need a top-level list not nested inside a folder. Before calling, check if you already have the necessary space ID from previous responses in the conversation, as this avoids redundant lookups. For creating lists inside folders, use create_list_in_folder instead.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         spaceId: {
                             type: "string",
-                            description: "ID of the space to create the list in (optional if using spaceName instead)"
+                            description: "ID of the space to create the list in (optional if using spaceName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         spaceName: {
                             type: "string",
-                            description: "Name of the space to create the list in - will automatically find the space by name (optional if using spaceId instead)"
+                            description: "Name of the space to create the list in - will automatically find the space by name (optional if using spaceId instead). Only use this if you don't already have the space ID from previous responses."
                         },
                         name: {
                             type: "string",
@@ -210,22 +210,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Status of the list"
                         }
                     },
-                    required: ["name"]
+                    required: []
                 }
             },
             {
                 name: "create_folder",
-                description: "Create a new folder in a ClickUp space for organizing related lists. Use this tool when you need to group multiple lists together. The tool can find spaces by name, so explicit space IDs aren't required. After creating a folder, you can add lists to it using create_list_in_folder.",
+                description: "Create a new folder in a ClickUp space for organizing related lists. Use this tool when you need to group multiple lists together. Before calling, check if you already have the necessary space ID from previous responses in the conversation, as this avoids redundant lookups. After creating a folder, you can add lists to it using create_list_in_folder.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         spaceId: {
                             type: "string",
-                            description: "ID of the space to create the folder in (optional if using spaceName instead)"
+                            description: "ID of the space to create the folder in (optional if using spaceName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         spaceName: {
                             type: "string",
-                            description: "Name of the space to create the folder in - will automatically find the space by name (optional if using spaceId instead)"
+                            description: "Name of the space to create the folder in - will automatically find the space by name (optional if using spaceId instead). Only use this if you don't already have the space ID from previous responses."
                         },
                         name: {
                             type: "string",
@@ -236,30 +236,30 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Whether to override space statuses with folder-specific statuses"
                         }
                     },
-                    required: ["name"]
+                    required: []
                 }
             },
             {
                 name: "create_list_in_folder",
-                description: "Create a new list within a ClickUp folder. Use this tool when you need to add a list to an existing folder structure. The tool can find folders and spaces by name, so explicit IDs aren't required. For top-level lists not in folders, use create_list instead.",
+                description: "Create a new list within a ClickUp folder. Use this tool when you need to add a list to an existing folder structure. Before calling, check if you already have the necessary folder ID and space ID from previous responses in the conversation, as this avoids redundant lookups. For top-level lists not in folders, use create_list instead.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         folderId: {
                             type: "string",
-                            description: "ID of the folder to create the list in (optional if using folderName instead)"
+                            description: "ID of the folder to create the list in (optional if using folderName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         folderName: {
                             type: "string",
-                            description: "Name of the folder to create the list in - will automatically find the folder by name (optional if using folderId instead)"
+                            description: "Name of the folder to create the list in - will automatically find the folder by name (optional if using folderId instead). Only use this if you don't already have the folder ID from previous responses."
                         },
                         spaceId: {
                             type: "string",
-                            description: "ID of the space containing the folder (optional if using spaceName instead)"
+                            description: "ID of the space containing the folder (optional if using spaceName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         spaceName: {
                             type: "string",
-                            description: "Name of the space containing the folder - will automatically find the space by name (optional if using spaceId instead)"
+                            description: "Name of the space containing the folder - will automatically find the space by name (optional if using spaceId instead). Only use this if you don't already have the space ID from previous responses."
                         },
                         name: {
                             type: "string",
@@ -274,22 +274,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Status of the list (uses folder default if not specified)"
                         }
                     },
-                    required: ["name"]
+                    required: []
                 }
             },
             {
                 name: "move_task",
-                description: "Move an existing task from its current list to a different list. Use this tool when you need to relocate a task within your workspace hierarchy. The tool can find tasks and lists by name, so explicit IDs aren't required. Task statuses may be reset if the destination list uses different status options.",
+                description: "Move an existing task from its current list to a different list. Use this tool when you need to relocate a task within your workspace hierarchy. Before calling, check if you already have the necessary task ID and list ID from previous responses in the conversation, as this avoids redundant lookups. Task statuses may be reset if the destination list uses different status options.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         taskId: {
                             type: "string",
-                            description: "ID of the task to move (optional if using taskName instead)"
+                            description: "ID of the task to move (optional if using taskName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         taskName: {
                             type: "string",
-                            description: "Name of the task to move - will automatically find the task by name (optional if using taskId instead)"
+                            description: "Name of the task to move - will automatically find the task by name (optional if using taskId instead). Only use this if you don't already have the task ID from previous responses."
                         },
                         sourceListName: {
                             type: "string",
@@ -297,29 +297,29 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         listId: {
                             type: "string",
-                            description: "ID of the destination list (optional if using listName instead)"
+                            description: "ID of the destination list (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         listName: {
                             type: "string",
-                            description: "Name of the destination list - will automatically find the list by name (optional if using listId instead)"
+                            description: "Name of the destination list - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses."
                         }
                     },
-                    required: ["taskName", "listName"]
+                    required: []
                 }
             },
             {
                 name: "duplicate_task",
-                description: "Create a copy of an existing task in the same or different list. Use this tool when you need to replicate a task's content and properties. The tool can find tasks and lists by name, so explicit IDs aren't required. The duplicate will preserve name, description, priority, and other attributes from the original task.",
+                description: "Create a copy of an existing task in the same or different list. Use this tool when you need to replicate a task's content and properties. Before calling, check if you already have the necessary task ID and list ID from previous responses in the conversation, as this avoids redundant lookups. The duplicate will preserve name, description, priority, and other attributes from the original task.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         taskId: {
                             type: "string",
-                            description: "ID of the task to duplicate (optional if using taskName instead)"
+                            description: "ID of the task to duplicate (optional if using taskName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         taskName: {
                             type: "string",
-                            description: "Name of the task to duplicate - will automatically find the task by name (optional if using taskId instead)"
+                            description: "Name of the task to duplicate - will automatically find the task by name (optional if using taskId instead). Only use this if you don't already have the task ID from previous responses."
                         },
                         sourceListName: {
                             type: "string",
@@ -327,29 +327,29 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         listId: {
                             type: "string",
-                            description: "ID of the list to create the duplicate in (optional if using listName instead)"
+                            description: "ID of the list to create the duplicate in (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         listName: {
                             type: "string",
-                            description: "Name of the list to create the duplicate in - will automatically find the list by name (optional if using listId instead)"
+                            description: "Name of the list to create the duplicate in - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses."
                         }
                     },
-                    required: ["taskName", "listName"]
+                    required: []
                 }
             },
             {
                 name: "update_task",
-                description: "Modify the properties of an existing task. Use this tool when you need to change a task's name, description, status, priority, or due date. The tool can find tasks by name, so explicit task IDs aren't required. Only the fields you specify will be updated; other fields will remain unchanged.",
+                description: "Modify the properties of an existing task. Use this tool when you need to change a task's name, description, status, priority, or due date. Before calling, check if you already have the necessary task ID from previous responses in the conversation, as this avoids redundant lookups. Only the fields you specify will be updated; other fields will remain unchanged.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         taskId: {
                             type: "string",
-                            description: "ID of the task to update (optional if using taskName instead)"
+                            description: "ID of the task to update (optional if using taskName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         taskName: {
                             type: "string",
-                            description: "Name of the task to update - will automatically find the task by name (optional if using taskId instead)"
+                            description: "Name of the task to update - will automatically find the task by name (optional if using taskId instead). Only use this if you don't already have the task ID from previous responses."
                         },
                         listName: {
                             type: "string",
@@ -363,35 +363,37 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             type: "string",
                             description: "New plain text description for the task"
                         },
+                        markdown_description: {
+                            type: "string",
+                            description: "New markdown formatted description for the task. If provided, this takes precedence over description"
+                        },
                         status: {
                             type: "string",
                             description: "New status for the task (must be a valid status in the task's list)"
                         },
                         priority: {
-                            type: "number",
-                            description: "New priority for the task (1-4), where 1 is urgent/highest priority and 4 is lowest priority"
-                        },
-                        dueDate: {
-                            type: "string",
-                            description: "New due date for the task (Unix timestamp in milliseconds). Convert dates to this format before submitting."
+                            type: ["number", "null"],
+                            enum: [1, 2, 3, 4, null],
+                            description: "New priority for the task (1-4 or null), where 1 is urgent/highest priority and 4 is lowest priority. Set to null to clear priority.",
+                            optional: true
                         }
                     },
-                    required: ["taskName"]
+                    required: []
                 }
             },
             {
                 name: "get_tasks",
-                description: "Retrieve tasks from a ClickUp list with optional filtering capabilities. Use this tool when you need to see existing tasks or analyze your current workload. The tool can find lists by name, eliminating the need for explicit list IDs. Results can be filtered by status, assignees, dates, and more.",
+                description: "Retrieve tasks from a ClickUp list with optional filtering capabilities. Use this tool when you need to see existing tasks or analyze your current workload. Before calling, check if you already have the necessary list ID from previous responses in the conversation, as this avoids redundant lookups. Results can be filtered by status, assignees, dates, and more.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         listId: {
                             type: "string",
-                            description: "ID of the list to get tasks from (optional if using listName instead)"
+                            description: "ID of the list to get tasks from (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         listName: {
                             type: "string",
-                            description: "Name of the list to get tasks from - will automatically find the list by name (optional if using listId instead)"
+                            description: "Name of the list to get tasks from - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses."
                         },
                         archived: {
                             type: "boolean",
@@ -456,51 +458,203 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Object with custom field IDs as keys and desired values for filtering"
                         }
                     },
-                    required: ["listName"]
+                    required: []
                 }
             },
             {
                 name: "get_task",
-                description: "Retrieve comprehensive details about a specific ClickUp task. Use this tool when you need in-depth information about a particular task, including its description, custom fields, attachments, and other metadata. The tool can find tasks by name, eliminating the need for explicit task IDs.",
+                description: "Retrieve comprehensive details about a specific ClickUp task. Use this tool when you need in-depth information about a particular task, including its description, custom fields, attachments, and other metadata. Before calling, check if you already have the necessary task ID from previous responses in the conversation, as this avoids redundant lookups.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         taskId: {
                             type: "string",
-                            description: "ID of the task to retrieve (optional if using taskName instead)"
+                            description: "ID of the task to retrieve (optional if using taskName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
                         },
                         taskName: {
                             type: "string",
-                            description: "Name of the task to retrieve - will automatically find the task by name (optional if using taskId instead)"
+                            description: "Name of the task to retrieve - will automatically find the task by name (optional if using taskId instead). Only use this if you don't already have the task ID from previous responses."
                         },
                         listName: {
                             type: "string",
                             description: "Optional: Name of the list to narrow down task search when multiple tasks have the same name"
                         }
                     },
-                    required: ["taskName"]
+                    required: []
                 }
             },
             {
                 name: "delete_task",
-                description: "Permanently remove a task from your ClickUp workspace. Use this tool with caution as deletion cannot be undone. The tool requires an explicit task ID for safety reasons, which you can obtain by first using get_task or get_tasks to find the appropriate task ID.",
+                description: "Permanently remove a task from your ClickUp workspace. Use this tool with caution as deletion cannot be undone. Before calling, check if you already have the necessary task ID from previous responses in the conversation, as this avoids redundant lookups. For safety, the task ID is required.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         taskId: {
                             type: "string",
-                            description: "ID of the task to delete - this is required for safety to prevent accidental deletions"
+                            description: "ID of the task to delete - this is required for safety to prevent accidental deletions. If you have this ID from a previous response, use it directly."
                         },
                         taskName: {
                             type: "string",
-                            description: "Name of the task to delete - will automatically find the task by name (optional if using taskId instead)"
+                            description: "Name of the task to delete - will automatically find the task by name (optional if using taskId instead). Only use this if you don't already have the task ID from previous responses."
                         },
                         listName: {
                             type: "string",
                             description: "Optional: Name of the list to narrow down task search when multiple tasks have the same name"
                         }
                     },
-                    required: ["taskId"]
+                    required: []
+                }
+            },
+            {
+                name: "get_folder",
+                description: "Retrieve details about a specific ClickUp folder including its name, status, and other metadata. Before calling, check if you already have the necessary folder ID from previous responses in the conversation history, as this avoids redundant lookups. Helps you understand folder structure before creating or updating lists.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        folderId: {
+                            type: "string",
+                            description: "ID of the folder to retrieve (optional if using folderName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        folderName: {
+                            type: "string",
+                            description: "Name of the folder to retrieve - will automatically find the folder by name (optional if using folderId instead). Only use this if you don't already have the folder ID from previous responses."
+                        },
+                        spaceId: {
+                            type: "string",
+                            description: "ID of the space containing the folder (optional if using spaceName instead, and only needed when using folderName). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        spaceName: {
+                            type: "string",
+                            description: "Name of the space containing the folder (optional if using spaceId instead, and only needed when using folderName). Only use this if you don't already have the space ID from previous responses."
+                        }
+                    },
+                    required: []
+                }
+            },
+            {
+                name: "update_folder",
+                description: "Modify an existing ClickUp folder's properties, such as name or status settings. Before calling, check if you already have the necessary folder ID from previous responses in the conversation history, as this avoids redundant lookups. Use when reorganizing or renaming workspace elements.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        folderId: {
+                            type: "string",
+                            description: "ID of the folder to update (optional if using folderName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        folderName: {
+                            type: "string",
+                            description: "Name of the folder to update - will automatically find the folder by name (optional if using folderId instead). Only use this if you don't already have the folder ID from previous responses."
+                        },
+                        spaceId: {
+                            type: "string",
+                            description: "ID of the space containing the folder (optional if using spaceName instead, and only needed when using folderName). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        spaceName: {
+                            type: "string",
+                            description: "Name of the space containing the folder (optional if using spaceId instead, and only needed when using folderName). Only use this if you don't already have the space ID from previous responses."
+                        },
+                        name: {
+                            type: "string",
+                            description: "New name for the folder"
+                        },
+                        override_statuses: {
+                            type: "boolean",
+                            description: "Whether to override space statuses with folder-specific statuses"
+                        }
+                    },
+                    required: []
+                }
+            },
+            {
+                name: "delete_folder",
+                description: "Permanently remove a folder from your ClickUp workspace. Use with caution as deletion cannot be undone and will remove all lists and tasks within the folder. Before calling, check if you already have the necessary folder ID from previous responses in the conversation history, as this avoids redundant lookups.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        folderId: {
+                            type: "string",
+                            description: "ID of the folder to delete (optional if using folderName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        folderName: {
+                            type: "string",
+                            description: "Name of the folder to delete - will automatically find the folder by name (optional if using folderId instead). Only use this if you don't already have the folder ID from previous responses."
+                        },
+                        spaceId: {
+                            type: "string",
+                            description: "ID of the space containing the folder (optional if using spaceName instead, and only needed when using folderName). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        spaceName: {
+                            type: "string",
+                            description: "Name of the space containing the folder (optional if using spaceId instead, and only needed when using folderName). Only use this if you don't already have the space ID from previous responses."
+                        }
+                    },
+                    required: []
+                }
+            },
+            {
+                name: "get_list",
+                description: "Retrieve details about a specific ClickUp list including its name, content, status options, and other metadata. Before calling, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups. Useful to understand list structure before creating or updating tasks.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        listId: {
+                            type: "string",
+                            description: "ID of the list to retrieve (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        listName: {
+                            type: "string",
+                            description: "Name of the list to retrieve - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses."
+                        }
+                    },
+                    required: []
+                }
+            },
+            {
+                name: "update_list",
+                description: "Modify an existing ClickUp list's properties, such as name, content, or status options. Before calling, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups. Use when reorganizing or renaming workspace elements.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        listId: {
+                            type: "string",
+                            description: "ID of the list to update (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        listName: {
+                            type: "string",
+                            description: "Name of the list to update - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses."
+                        },
+                        name: {
+                            type: "string",
+                            description: "New name for the list"
+                        },
+                        content: {
+                            type: "string",
+                            description: "New description or content for the list"
+                        },
+                        status: {
+                            type: "string",
+                            description: "New status for the list"
+                        }
+                    },
+                    required: []
+                }
+            },
+            {
+                name: "delete_list",
+                description: "Permanently remove a list from your ClickUp workspace. Use with caution as deletion cannot be undone and will remove all tasks within the list. Before calling, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        listId: {
+                            type: "string",
+                            description: "ID of the list to delete (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name."
+                        },
+                        listName: {
+                            type: "string",
+                            description: "Name of the list to delete - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses."
+                        }
+                    },
+                    required: []
                 }
             }
         ]
@@ -578,12 +732,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "create_bulk_tasks": {
                 const args = request.params.arguments;
-                if (!args.listId && !args.listName) {
-                    throw new Error("Either listId or listName is required");
-                }
-                if (!args.tasks || args.tasks.length === 0) {
+                // First validate tasks array
+                if (!args.tasks || !Array.isArray(args.tasks) || args.tasks.length === 0) {
                     throw new Error("tasks array is required and must not be empty");
                 }
+                // Validate each task has required fields
+                args.tasks.forEach((task, index) => {
+                    if (!task.name) {
+                        throw new Error(`Task at index ${index} is missing required field 'name'`);
+                    }
+                });
+                // Get listId from name if needed
                 let listId = args.listId;
                 if (!listId && args.listName) {
                     const result = await clickup.findListIDByName(args.listName);
@@ -592,12 +751,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     }
                     listId = result.id;
                 }
+                // Now validate we have a listId
+                if (!listId) {
+                    throw new Error("Either listId or listName must be provided");
+                }
                 const { listId: _, listName: __, tasks } = args;
                 const createdTasks = await clickup.createBulkTasks(listId, { tasks });
                 return {
                     content: [{
                             type: "text",
-                            text: `Created ${createdTasks.length} tasks`
+                            text: JSON.stringify({
+                                message: `Created ${createdTasks.length} tasks`,
+                                tasks: createdTasks.map(task => ({
+                                    id: task.id,
+                                    name: task.name,
+                                    url: task.url
+                                }))
+                            }, null, 2)
                         }]
                 };
             }
@@ -750,9 +920,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "update_task": {
                 const args = request.params.arguments;
+                // Require either taskId or taskName
                 if (!args.taskId && !args.taskName) {
                     throw new Error("Either taskId or taskName is required");
                 }
+                // Get taskId from taskName if needed
                 let taskId = args.taskId;
                 if (!taskId && args.taskName) {
                     const result = await clickup.findTaskByName(args.taskName, undefined, args.listName);
@@ -761,7 +933,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     }
                     taskId = result.id;
                 }
+                // Remove helper fields before updating
                 const { taskId: _, taskName: __, listName: ___, ...updateData } = args;
+                // Ensure priority is properly handled
+                if (updateData.priority !== undefined && updateData.priority !== null) {
+                    const priority = Number(updateData.priority);
+                    if (isNaN(priority) || ![1, 2, 3, 4].includes(priority)) {
+                        throw new Error("Priority must be a number between 1 and 4, or null to clear priority");
+                    }
+                    updateData.priority = priority;
+                }
                 const task = await clickup.updateTask(taskId, updateData);
                 return {
                     content: [{
@@ -841,6 +1022,243 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         }]
                 };
             }
+            case "get_folder": {
+                const args = request.params.arguments;
+                if (!args.folderId && !args.folderName) {
+                    throw new Error("Either folderId or folderName is required");
+                }
+                let folderId = args.folderId;
+                if (!folderId && args.folderName) {
+                    // If we need to look up by name, we might need the space
+                    let spaceId = args.spaceId;
+                    if (!spaceId && args.spaceName) {
+                        const foundId = await clickup.findSpaceIDByName(args.spaceName);
+                        if (!foundId) {
+                            throw new Error(`Space with name "${args.spaceName}" not found`);
+                        }
+                        spaceId = foundId;
+                    }
+                    if (!spaceId) {
+                        // Try to find folder directly by name (will search across all spaces)
+                        const result = await clickup.findFolderIDByName(args.folderName);
+                        if (!result) {
+                            throw new Error(`Folder with name "${args.folderName}" not found`);
+                        }
+                        folderId = result.id;
+                    }
+                    else {
+                        // Look in a specific space
+                        const folder = await clickup.findFolderByName(spaceId, args.folderName);
+                        if (!folder) {
+                            throw new Error(`Folder with name "${args.folderName}" not found in specified space`);
+                        }
+                        folderId = folder.id;
+                    }
+                }
+                // Ensure folderId is defined at this point
+                if (!folderId) {
+                    throw new Error("Failed to determine folder ID");
+                }
+                const folder = await clickup.getFolder(folderId);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify(folder, null, 2)
+                        }]
+                };
+            }
+            case "update_folder": {
+                const args = request.params.arguments;
+                if (!args.folderId && !args.folderName) {
+                    throw new Error("Either folderId or folderName is required");
+                }
+                let folderId = args.folderId;
+                if (!folderId && args.folderName) {
+                    // If we need to look up by name, we might need the space
+                    let spaceId = args.spaceId;
+                    if (!spaceId && args.spaceName) {
+                        const foundId = await clickup.findSpaceIDByName(args.spaceName);
+                        if (!foundId) {
+                            throw new Error(`Space with name "${args.spaceName}" not found`);
+                        }
+                        spaceId = foundId;
+                    }
+                    if (!spaceId) {
+                        // Try to find folder directly by name (will search across all spaces)
+                        const result = await clickup.findFolderIDByName(args.folderName);
+                        if (!result) {
+                            throw new Error(`Folder with name "${args.folderName}" not found`);
+                        }
+                        folderId = result.id;
+                    }
+                    else {
+                        // Look in a specific space
+                        const folder = await clickup.findFolderByName(spaceId, args.folderName);
+                        if (!folder) {
+                            throw new Error(`Folder with name "${args.folderName}" not found in specified space`);
+                        }
+                        folderId = folder.id;
+                    }
+                }
+                // Ensure folderId is defined at this point
+                if (!folderId) {
+                    throw new Error("Failed to determine folder ID");
+                }
+                // Extract update data
+                const { folderId: _, folderName: __, spaceId: ___, spaceName: ____, ...updateData } = args;
+                // Call the updateFolder method
+                const updatedFolder = await clickup.updateFolder(folderId, updateData);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Updated folder ${updatedFolder.id}: ${updatedFolder.name}`
+                        }]
+                };
+            }
+            case "delete_folder": {
+                const args = request.params.arguments;
+                if (!args.folderId && !args.folderName) {
+                    throw new Error("Either folderId or folderName is required");
+                }
+                let folderId = args.folderId;
+                if (!folderId && args.folderName) {
+                    // If we need to look up by name, we might need the space
+                    let spaceId = args.spaceId;
+                    if (!spaceId && args.spaceName) {
+                        const foundId = await clickup.findSpaceIDByName(args.spaceName);
+                        if (!foundId) {
+                            throw new Error(`Space with name "${args.spaceName}" not found`);
+                        }
+                        spaceId = foundId;
+                    }
+                    if (!spaceId) {
+                        // Try to find folder directly by name (will search across all spaces)
+                        const result = await clickup.findFolderIDByName(args.folderName);
+                        if (!result) {
+                            throw new Error(`Folder with name "${args.folderName}" not found`);
+                        }
+                        folderId = result.id;
+                    }
+                    else {
+                        // Look in a specific space
+                        const folder = await clickup.findFolderByName(spaceId, args.folderName);
+                        if (!folder) {
+                            throw new Error(`Folder with name "${args.folderName}" not found in specified space`);
+                        }
+                        folderId = folder.id;
+                    }
+                }
+                // Ensure folderId is defined at this point
+                if (!folderId) {
+                    throw new Error("Failed to determine folder ID");
+                }
+                // Store the folder name before deletion for the response message
+                let folderName = args.folderName;
+                if (!folderName) {
+                    try {
+                        const folderDetails = await clickup.getFolder(folderId);
+                        folderName = folderDetails.name;
+                    }
+                    catch (error) {
+                        // If we can't get the folder details, just use the ID in the response
+                    }
+                }
+                await clickup.deleteFolder(folderId);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Successfully deleted folder ${folderName || folderId}`
+                        }]
+                };
+            }
+            case "get_list": {
+                const args = request.params.arguments;
+                if (!args.listId && !args.listName) {
+                    throw new Error("Either listId or listName is required");
+                }
+                let listId = args.listId;
+                if (!listId && args.listName) {
+                    const result = await clickup.findListIDByName(args.listName);
+                    if (!result) {
+                        throw new Error(`List with name "${args.listName}" not found`);
+                    }
+                    listId = result.id;
+                }
+                // Ensure listId is defined at this point
+                if (!listId) {
+                    throw new Error("Failed to determine list ID");
+                }
+                const listDetails = await clickup.getList(listId);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify(listDetails, null, 2)
+                        }]
+                };
+            }
+            case "update_list": {
+                const args = request.params.arguments;
+                if (!args.listId && !args.listName) {
+                    throw new Error("Either listId or listName is required");
+                }
+                let listId = args.listId;
+                if (!listId && args.listName) {
+                    const result = await clickup.findListIDByName(args.listName);
+                    if (!result) {
+                        throw new Error(`List with name "${args.listName}" not found`);
+                    }
+                    listId = result.id;
+                }
+                // Ensure listId is defined at this point
+                if (!listId) {
+                    throw new Error("Failed to determine list ID");
+                }
+                // Extract update data
+                const { listId: _, listName: __, ...updateData } = args;
+                const updatedList = await clickup.updateList(listId, updateData);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Updated list ${updatedList.id}: ${updatedList.name}`
+                        }]
+                };
+            }
+            case "delete_list": {
+                const args = request.params.arguments;
+                if (!args.listId && !args.listName) {
+                    throw new Error("Either listId or listName is required");
+                }
+                let listId = args.listId;
+                if (!listId && args.listName) {
+                    const result = await clickup.findListIDByName(args.listName);
+                    if (!result) {
+                        throw new Error(`List with name "${args.listName}" not found`);
+                    }
+                    listId = result.id;
+                }
+                // Ensure listId is defined at this point
+                if (!listId) {
+                    throw new Error("Failed to determine list ID");
+                }
+                // Store the list name before deletion for the response message
+                let listName = args.listName;
+                if (!listName) {
+                    try {
+                        const listDetails = await clickup.getList(listId);
+                        listName = listDetails.name;
+                    }
+                    catch (error) {
+                        // If we can't get the list details, just use the ID in the response
+                    }
+                }
+                await clickup.deleteList(listId);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Successfully deleted list ${listName || listId}`
+                        }]
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${request.params.name}`);
         }

package/build/services/clickup.js

@@ -59,16 +59,7 @@ export class ClickUpService {
      */
     async makeRequest(requestFn) {
         await this.checkRateLimit();
-        try {
-            return await requestFn();
-        }
-        catch (error) {
-            if (error.response?.status === 429) {
-                // Let the interceptor handle it
-                throw error;
-            }
-            throw error;
-        }
+        return await requestFn();
     }
     /**
      * Initializes the ClickUpService singleton instance.
@@ -183,10 +174,15 @@ export class ClickUpService {
     async createTask(listId, data) {
         return this.makeRequest(async () => {
             const taskData = { ...data };
-            if (taskData.description && /[#*`\-\[\]>]/.test(taskData.description)) {
-                taskData.markdown_description = taskData.description;
+            // If markdown_description is provided, it takes precedence
+            if (taskData.markdown_description) {
+                // Ensure we don't send both to avoid confusion
                 delete taskData.description;
             }
+            else if (taskData.description) {
+                // Only use description as-is, don't auto-convert to markdown
+                taskData.description = taskData.description.trim();
+            }
             const response = await this.client.post(`/list/${listId}/task`, taskData);
             return response.data;
         });
@@ -200,10 +196,15 @@ export class ClickUpService {
         for (const taskData of data.tasks) {
             await this.makeRequest(async () => {
                 const processedTask = { ...taskData };
-                if (processedTask.description && /[#*`\-\[\]>]/.test(processedTask.description)) {
-                    processedTask.markdown_description = processedTask.description;
+                // If markdown_description is provided, it takes precedence
+                if (processedTask.markdown_description) {
+                    // Ensure we don't send both to avoid confusion
                     delete processedTask.description;
                 }
+                else if (processedTask.description) {
+                    // Only use description as-is, don't auto-convert to markdown
+                    processedTask.description = processedTask.description.trim();
+                }
                 const response = await this.client.post(`/list/${listId}/task`, processedTask);
                 createdTasks.push(response.data);
             });
@@ -216,7 +217,21 @@ export class ClickUpService {
      */
     async updateTask(taskId, data) {
         return this.makeRequest(async () => {
-            const response = await this.client.put(`/task/${taskId}`, data);
+            const updateData = { ...data };
+            // If markdown_description is provided, it takes precedence
+            if (updateData.markdown_description) {
+                // Ensure we don't send both to avoid confusion
+                delete updateData.description;
+            }
+            else if (updateData.description) {
+                // Only use description as-is, don't auto-convert to markdown
+                updateData.description = updateData.description.trim();
+            }
+            // Handle null priority explicitly
+            if (updateData.priority === null) {
+                updateData.priority = null;
+            }
+            const response = await this.client.put(`/task/${taskId}`, updateData);
             return response.data;
         });
     }
@@ -309,9 +324,16 @@ export class ClickUpService {
             return response.data;
         });
     }
-    async createFolder(spaceId, data) {
+    /**
+     * Updates an existing folder with new data.
+     * @param folderId - ID of the folder to update
+     * @param data - Data to update the folder with (name, override_statuses)
+     * @returns Promise resolving to the updated ClickUpFolder
+     * @throws Error if the API request fails
+     */
+    async updateFolder(folderId, data) {
         return this.makeRequest(async () => {
-            const response = await this.client.post(`/space/${spaceId}/folder`, data);
+            const response = await this.client.put(`/folder/${folderId}`, data);
             return response.data;
         });
     }
@@ -337,6 +359,19 @@ export class ClickUpService {
         const folders = await this.getFolders(spaceId);
         return folders.find(folder => folder.name.toLowerCase() === folderName.toLowerCase()) || null;
     }
+    /**
+     * Creates a new folder in a space.
+     * @param spaceId - ID of the space to create the folder in
+     * @param data - Folder creation data (name, override_statuses)
+     * @returns Promise resolving to the created ClickUpFolder
+     * @throws Error if the API request fails
+     */
+    async createFolder(spaceId, data) {
+        return this.makeRequest(async () => {
+            const response = await this.client.post(`/space/${spaceId}/folder`, data);
+            return response.data;
+        });
+    }
     // Additional helper methods
     /**
      * Moves a task to a different list.
@@ -710,11 +745,4 @@ export class ClickUpService {
             : `${task.space.name} > ${task.list.name} > ${task.name}`;
         return { id: task.id, path };
     }
-    async getTaskStatuses(listId) {
-        const response = await this.getTasks(listId);
-        const statuses = [...new Set(response.tasks
-                .filter((task) => task.status !== undefined)
-                .map((task) => task.status.status))];
-        return statuses;
-    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taazkareem/clickup-mcp-server",
-  "version": "0.4.54",
+  "version": "0.4.57",
   "description": "ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",
@@ -36,7 +36,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/taazkareem/clickup-mcp-server.git"
+    "url": "git+https://github.com/taazkareem/clickup-mcp-server.git"
   },
   "bugs": {
     "url": "https://github.com/taazkareem/clickup-mcp-server/issues"
@@ -44,10 +44,8 @@
   "homepage": "https://github.com/taazkareem/clickup-mcp-server#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "0.6.0",
-    "@types/express": "^5.0.0",
     "axios": "^1.6.7",
-    "dotenv": "^16.4.1",
-    "express": "^4.21.2"
+    "dotenv": "^16.4.1"
   },
   "devDependencies": {
     "@types/node": "^20.11.16",