@taazkareem/clickup-mcp-server 0.4.58 → 0.4.60

package/README.md

@@ -38,6 +38,7 @@ npx -y @taazkareem/clickup-mcp-server \
   - Full CRUD operations for workspace components
   - Efficient path-based navigation
 
+
 - 🔄 **Integration Features**
   - Name or ID-based item lookup
   - Case-insensitive name matching
@@ -60,7 +61,7 @@ npx -y @taazkareem/clickup-mcp-server \
 | [update_task](docs/api-reference.md#task-management) | Modify task | `taskId`/`taskName` |
 | [get_tasks](docs/api-reference.md#task-retrieval) | Get tasks from list | `listId`/`listName` |
 | [get_task](docs/api-reference.md#task-retrieval) | Get task details | `taskId`/`taskName` |
-| [delete_task](docs/api-reference.md#task-management) | Remove task | `taskId` |
+| [delete_task](docs/api-reference.md#task-management) | Remove task | `taskId`/`taskName` |
 | [move_task](docs/api-reference.md#task-management) | Move task | `taskId`/`taskName`, `listId`/`listName` |
 | [duplicate_task](docs/api-reference.md#task-management) | Copy task | `taskId`/`taskName`, `listId`/`listName` |
 | [create_list](docs/api-reference.md#list-management) | Create list in space | `name`, `spaceId`/`spaceName` |

package/build/index.js

@@ -109,11 +109,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Due date of the task (Unix timestamp in milliseconds). Convert dates to this format before submitting."
                         }
                     },
-                    required: ["name"],
-                    oneOf: [
-                        { required: ["listId"] },
-                        { required: ["listName"] }
-                    ]
+                    required: ["name"]
                 }
             },
             {
@@ -168,15 +164,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                                         description: "Array of user IDs to assign to the task"
                                     }
                                 },
-                                required: ["name"]
+                                required: []
                             }
                         }
                     },
-                    required: ["tasks"],
-                    oneOf: [
-                        { required: ["listId"] },
-                        { required: ["listName"] }
-                    ]
+                    required: ["tasks"]
                 }
             },
             {
@@ -187,11 +179,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     properties: {
                         spaceId: {
                             type: "string",
-                            description: "ID of the space to create the list in (required if not using folderId). If you have this ID from a previous response, use it directly rather than looking up by name."
+                            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."
                         },
-                        folderId: {
+                        spaceName: {
                             type: "string",
-                            description: "ID of the folder to create the list in (required if not using spaceId). If you have this ID from a previous response, use it directly rather than looking up by name."
+                            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",
@@ -201,34 +193,24 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             type: "string",
                             description: "Description or content of the list"
                         },
-                        assignee: {
-                            type: "number",
-                            description: "User ID to assign the list to"
+                        dueDate: {
+                            type: "string",
+                            description: "Due date for the list (Unix timestamp in milliseconds). Convert dates to this format before submitting."
                         },
                         priority: {
                             type: "number",
                             description: "Priority of the list (1-4), where 1 is urgent/highest priority and 4 is lowest priority. Only set when explicitly requested."
                         },
-                        dueDate: {
-                            type: "string",
-                            description: "Due date for the list (Unix timestamp in milliseconds). Convert dates to this format before submitting."
+                        assignee: {
+                            type: "number",
+                            description: "User ID to assign the list to"
                         },
                         status: {
                             type: "string",
                             description: "Status of the list"
                         }
                     },
-                    allOf: [
-                        {
-                            oneOf: [
-                                { required: ["spaceId"] },
-                                { required: ["folderId"] }
-                            ]
-                        },
-                        {
-                            required: ["name"]
-                        }
-                    ]
+                    required: ["name"]
                 }
             },
             {
@@ -254,11 +236,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Whether to override space statuses with folder-specific statuses"
                         }
                     },
-                    required: ["name"],
-                    oneOf: [
-                        { required: ["spaceId"] },
-                        { required: ["spaceName"] }
-                    ]
+                    required: ["name"]
                 }
             },
             {
@@ -267,6 +245,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 inputSchema: {
                     type: "object",
                     properties: {
+                        name: {
+                            type: "string",
+                            description: "Name of the list"
+                        },
                         folderId: {
                             type: "string",
                             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."
@@ -283,10 +265,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             type: "string",
                             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",
-                            description: "Name of the list"
-                        },
                         content: {
                             type: "string",
                             description: "Description or content of the list"
@@ -296,12 +274,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Status of the list (uses folder default if not specified)"
                         }
                     },
-                    required: ["name"],
-                    oneOf: [
-                        { required: ["folderId"] },
-                        { required: ["folderName", "spaceId"] },
-                        { required: ["folderName", "spaceName"] }
-                    ]
+                    required: ["name"]
                 }
             },
             {
@@ -331,20 +304,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             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."
                         }
                     },
-                    allOf: [
-                        {
-                            oneOf: [
-                                { required: ["taskId"] },
-                                { required: ["taskName"] }
-                            ]
-                        },
-                        {
-                            oneOf: [
-                                { required: ["listId"] },
-                                { required: ["listName"] }
-                            ]
-                        }
-                    ]
+                    required: []
                 }
             },
             {
@@ -374,20 +334,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             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."
                         }
                     },
-                    allOf: [
-                        {
-                            oneOf: [
-                                { required: ["taskId"] },
-                                { required: ["taskName"] }
-                            ]
-                        },
-                        {
-                            oneOf: [
-                                { required: ["listId"] },
-                                { required: ["listName"] }
-                            ]
-                        }
-                    ]
+                    required: []
                 }
             },
             {
@@ -431,10 +378,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             optional: true
                         }
                     },
-                    oneOf: [
-                        { required: ["taskId"] },
-                        { required: ["taskName"] }
-                    ]
+                    required: []
                 }
             },
             {
@@ -514,10 +458,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Object with custom field IDs as keys and desired values for filtering"
                         }
                     },
-                    oneOf: [
-                        { required: ["listId"] },
-                        { required: ["listName"] }
-                    ]
+                    required: []
                 }
             },
             {
@@ -539,10 +480,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Optional: Name of the list to narrow down task search when multiple tasks have the same name"
                         }
                     },
-                    oneOf: [
-                        { required: ["taskId"] },
-                        { required: ["taskName"] }
-                    ]
+                    required: []
                 }
             },
             {
@@ -564,7 +502,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Optional: Name of the list to narrow down task search when multiple tasks have the same name"
                         }
                     },
-                    required: ["taskId"]
+                    required: []
                 }
             },
             {
@@ -590,11 +528,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             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."
                         }
                     },
-                    oneOf: [
-                        { required: ["folderId"] },
-                        { required: ["folderName", "spaceId"] },
-                        { required: ["folderName", "spaceName"] }
-                    ]
+                    required: []
                 }
             },
             {
@@ -628,11 +562,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Whether to override space statuses with folder-specific statuses"
                         }
                     },
-                    oneOf: [
-                        { required: ["folderId"] },
-                        { required: ["folderName", "spaceId"] },
-                        { required: ["folderName", "spaceName"] }
-                    ]
+                    required: []
                 }
             },
             {
@@ -658,11 +588,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             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."
                         }
                     },
-                    oneOf: [
-                        { required: ["folderId"] },
-                        { required: ["folderName", "spaceId"] },
-                        { required: ["folderName", "spaceName"] }
-                    ]
+                    required: []
                 }
             },
             {
@@ -680,10 +606,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             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."
                         }
                     },
-                    oneOf: [
-                        { required: ["listId"] },
-                        { required: ["listName"] }
-                    ]
+                    required: []
                 }
             },
             {
@@ -713,10 +636,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "New status for the list"
                         }
                     },
-                    oneOf: [
-                        { required: ["listId"] },
-                        { required: ["listName"] }
-                    ]
+                    required: []
                 }
             },
             {
@@ -734,10 +654,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             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."
                         }
                     },
-                    oneOf: [
-                        { required: ["listId"] },
-                        { required: ["listName"] }
-                    ]
+                    required: []
                 }
             }
         ]
@@ -855,54 +772,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case "create_list": {
-                const args = request.params.arguments ? request.params.arguments : { name: '' };
+                const args = request.params.arguments;
                 if (!args.name) {
-                    throw new Error("List name is required");
-                }
-                // Validate that we have either spaceId/spaceName OR folderId/folderName, but not both
-                const hasSpace = !!(args.spaceId || args.spaceName);
-                const hasFolder = !!(args.folderId || args.folderName);
-                if (!hasSpace && !hasFolder) {
-                    throw new Error("Either spaceId/spaceName or folderId/folderName must be provided");
-                }
-                if (hasSpace && hasFolder) {
-                    throw new Error("Cannot provide both space and folder identifiers. Use either spaceId/spaceName OR folderId/folderName");
-                }
-                // Prepare the list data
-                const listData = {
-                    name: args.name,
-                    content: args.content,
-                    due_date: args.dueDate,
-                    priority: args.priority,
-                    assignee: args.assignee,
-                    status: args.status
-                };
-                let list;
-                if (hasSpace) {
-                    // Handle space-based creation
-                    let spaceId = args.spaceId;
-                    if (!spaceId && args.spaceName) {
-                        const teamId = await clickup.getTeamId();
-                        const space = await clickup.findSpaceByName(args.spaceName, teamId);
-                        if (!space) {
-                            throw new Error(`Space with name "${args.spaceName}" not found`);
-                        }
-                        spaceId = space.id;
-                    }
-                    list = await clickup.createList(spaceId, listData);
+                    throw new Error("name is required");
                 }
-                else {
-                    // Handle folder-based creation
-                    let folderId = args.folderId;
-                    if (!folderId && args.folderName) {
-                        const result = await clickup.findFolderIDByName(args.folderName);
-                        if (!result) {
-                            throw new Error(`Folder with name "${args.folderName}" not found`);
-                        }
-                        folderId = result.id;
+                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`);
                     }
-                    list = await clickup.createListInFolder(folderId, listData);
+                    spaceId = foundId;
+                }
+                if (!spaceId) {
+                    throw new Error("Either spaceId or spaceName must be provided");
                 }
+                const { spaceId: _, spaceName: __, ...listData } = args;
+                const list = await clickup.createList(spaceId, listData);
                 return {
                     content: [{
                             type: "text",
@@ -1113,26 +999,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "delete_task": {
                 const args = request.params.arguments;
-                // Validate the required taskId parameter
-                if (!args.taskId) {
-                    throw new Error("taskId is required for deletion operations");
-                }
-                // Store the task name before deletion for the response message
-                let taskName = args.taskName;
-                if (!taskName) {
-                    try {
-                        const task = await clickup.getTask(args.taskId);
-                        taskName = task.name;
-                    }
-                    catch (error) {
-                        // If we can't get the task details, just use the ID in the response
-                    }
+                if (!args.taskId && !args.taskName) {
+                    throw new Error("Either taskId or taskName is required");
                 }
-                await clickup.deleteTask(args.taskId);
+                await clickup.deleteTask(args.taskId, args.taskName, args.listName);
                 return {
                     content: [{
                             type: "text",
-                            text: `Successfully deleted task ${taskName || args.taskId}`
+                            text: `Successfully deleted task${args.taskName ? ` "${args.taskName}"` : ` with ID ${args.taskId}`}`
                         }]
                 };
             }

package/build/services/clickup.js

@@ -85,13 +85,6 @@ export class ClickUpService {
         }
         return ClickUpService.instance;
     }
-    /**
-     * Gets the team/workspace ID that was set during initialization.
-     * @returns The team/workspace ID
-     */
-    getTeamId() {
-        return this.clickupTeamId;
-    }
     // Tasks
     /**
      * Retrieves tasks from a specific list with optional filtering.
@@ -244,11 +237,28 @@ export class ClickUpService {
     }
     /**
      * Deletes a task from the workspace.
+     * Can delete by taskId directly or find by taskName first.
      * Handles rate limiting automatically.
+     * @param taskId - ID of the task to delete (optional if taskName provided)
+     * @param taskName - Name of the task to delete (optional if taskId provided)
+     * @param listName - Optional list name to narrow down task search
+     * @throws Error if neither taskId nor taskName is provided, or if task not found
      */
-    async deleteTask(taskId) {
+    async deleteTask(taskId, taskName, listName) {
         return this.makeRequest(async () => {
-            await this.client.delete(`/task/${taskId}`);
+            let finalTaskId = taskId;
+            // If no taskId but taskName provided, find the task first
+            if (!taskId && taskName) {
+                const taskInfo = await this.findTaskByName(taskName, undefined, listName);
+                if (!taskInfo) {
+                    throw new Error(`Task "${taskName}" not found${listName ? ` in list "${listName}"` : ''}`);
+                }
+                finalTaskId = taskInfo.id;
+            }
+            if (!finalTaskId) {
+                throw new Error('Either taskId or taskName must be provided');
+            }
+            await this.client.delete(`/task/${finalTaskId}`);
         });
     }
     // Lists
@@ -307,9 +317,6 @@ export class ClickUpService {
     }
     /**
      * Creates a new list in a space.
-     * Note: ClickUp API requires lists to be in folders, so this will:
-     * 1. Create a default folder if none specified
-     * 2. Create the list within that folder
      * @param spaceId - ID of the space to create the list in
      * @param data - List creation data (name, content, due date, etc.)
      * @returns Promise resolving to the created ClickUpList
@@ -317,17 +324,7 @@ export class ClickUpService {
      */
     async createList(spaceId, data) {
         return this.makeRequest(async () => {
-            // First, get or create a default folder
-            const folders = await this.getFolders(spaceId);
-            let defaultFolder = folders.find(f => f.name === 'Default Lists');
-            if (!defaultFolder) {
-                // Create a default folder if none exists
-                defaultFolder = await this.createFolder(spaceId, {
-                    name: 'Default Lists'
-                });
-            }
-            // Create the list within the default folder
-            const response = await this.client.post(`/folder/${defaultFolder.id}/list`, data);
+            const response = await this.client.post(`/space/${spaceId}/list`, data);
             return response.data;
         });
     }

package/package.json

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