npm - @taazkareem/clickup-mcp-server - Versions diffs - 0.4.57 → 0.4.58 - Mend

@taazkareem/clickup-mcp-server 0.4.57 → 0.4.58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md +0 -1
package/build/index.js +154 -40
package/build/services/clickup.js +21 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -38,7 +38,6 @@ 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

package/build/index.js CHANGED Viewed

@@ -109,7 +109,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Due date of the task (Unix timestamp in milliseconds). Convert dates to this format before submitting."
                         }
                     },
-                    required: []
+                    required: ["name"],
+                    oneOf: [
+                        { required: ["listId"] },
+                        { required: ["listName"] }
+                    ]
                 }
             },
             {
@@ -164,11 +168,15 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                                         description: "Array of user IDs to assign to the task"
                                     }
                                 },
-                                required: []
+                                required: ["name"]
                             }
                         }
                     },
-                    required: []
+                    required: ["tasks"],
+                    oneOf: [
+                        { required: ["listId"] },
+                        { required: ["listName"] }
+                    ]
                 }
             },
             {
@@ -179,11 +187,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     properties: {
                         spaceId: {
                             type: "string",
-                            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."
+                            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."
                         },
-                        spaceName: {
+                        folderId: {
                             type: "string",
-                            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."
+                            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."
                         },
                         name: {
                             type: "string",
@@ -193,24 +201,34 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             type: "string",
                             description: "Description or content of the list"
                         },
-                        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"
                         },
                         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."
                         },
-                        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."
                         },
                         status: {
                             type: "string",
                             description: "Status of the list"
                         }
                     },
-                    required: []
+                    allOf: [
+                        {
+                            oneOf: [
+                                { required: ["spaceId"] },
+                                { required: ["folderId"] }
+                            ]
+                        },
+                        {
+                            required: ["name"]
+                        }
+                    ]
                 }
             },
             {
@@ -236,7 +254,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Whether to override space statuses with folder-specific statuses"
                         }
                     },
-                    required: []
+                    required: ["name"],
+                    oneOf: [
+                        { required: ["spaceId"] },
+                        { required: ["spaceName"] }
+                    ]
                 }
             },
             {
@@ -274,7 +296,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Status of the list (uses folder default if not specified)"
                         }
                     },
-                    required: []
+                    required: ["name"],
+                    oneOf: [
+                        { required: ["folderId"] },
+                        { required: ["folderName", "spaceId"] },
+                        { required: ["folderName", "spaceName"] }
+                    ]
                 }
             },
             {
@@ -304,7 +331,20 @@ 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."
                         }
                     },
-                    required: []
+                    allOf: [
+                        {
+                            oneOf: [
+                                { required: ["taskId"] },
+                                { required: ["taskName"] }
+                            ]
+                        },
+                        {
+                            oneOf: [
+                                { required: ["listId"] },
+                                { required: ["listName"] }
+                            ]
+                        }
+                    ]
                 }
             },
             {
@@ -334,7 +374,20 @@ 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."
                         }
                     },
-                    required: []
+                    allOf: [
+                        {
+                            oneOf: [
+                                { required: ["taskId"] },
+                                { required: ["taskName"] }
+                            ]
+                        },
+                        {
+                            oneOf: [
+                                { required: ["listId"] },
+                                { required: ["listName"] }
+                            ]
+                        }
+                    ]
                 }
             },
             {
@@ -378,7 +431,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             optional: true
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["taskId"] },
+                        { required: ["taskName"] }
+                    ]
                 }
             },
             {
@@ -458,7 +514,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Object with custom field IDs as keys and desired values for filtering"
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["listId"] },
+                        { required: ["listName"] }
+                    ]
                 }
             },
             {
@@ -480,7 +539,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Optional: Name of the list to narrow down task search when multiple tasks have the same name"
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["taskId"] },
+                        { required: ["taskName"] }
+                    ]
                 }
             },
             {
@@ -502,7 +564,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Optional: Name of the list to narrow down task search when multiple tasks have the same name"
                         }
                     },
-                    required: []
+                    required: ["taskId"]
                 }
             },
             {
@@ -528,7 +590,11 @@ 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."
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["folderId"] },
+                        { required: ["folderName", "spaceId"] },
+                        { required: ["folderName", "spaceName"] }
+                    ]
                 }
             },
             {
@@ -562,7 +628,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Whether to override space statuses with folder-specific statuses"
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["folderId"] },
+                        { required: ["folderName", "spaceId"] },
+                        { required: ["folderName", "spaceName"] }
+                    ]
                 }
             },
             {
@@ -588,7 +658,11 @@ 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."
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["folderId"] },
+                        { required: ["folderName", "spaceId"] },
+                        { required: ["folderName", "spaceName"] }
+                    ]
                 }
             },
             {
@@ -606,7 +680,10 @@ 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."
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["listId"] },
+                        { required: ["listName"] }
+                    ]
                 }
             },
             {
@@ -636,7 +713,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "New status for the list"
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["listId"] },
+                        { required: ["listName"] }
+                    ]
                 }
             },
             {
@@ -654,7 +734,10 @@ 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."
                         }
                     },
-                    required: []
+                    oneOf: [
+                        { required: ["listId"] },
+                        { required: ["listName"] }
+                    ]
                 }
             }
         ]
@@ -772,23 +855,54 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case "create_list": {
-                const args = request.params.arguments;
+                const args = request.params.arguments ? request.params.arguments : { name: '' };
                 if (!args.name) {
-                    throw new Error("name is required");
-                }
-                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`);
+                    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;
                     }
-                    spaceId = foundId;
+                    list = await clickup.createList(spaceId, listData);
                 }
-                if (!spaceId) {
-                    throw new Error("Either spaceId or spaceName must be provided");
+                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;
+                    }
+                    list = await clickup.createListInFolder(folderId, listData);
                 }
-                const { spaceId: _, spaceName: __, ...listData } = args;
-                const list = await clickup.createList(spaceId, listData);
                 return {
                     content: [{
                             type: "text",

package/build/services/clickup.js CHANGED Viewed

@@ -85,6 +85,13 @@ 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.
@@ -300,6 +307,9 @@ 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
@@ -307,7 +317,17 @@ export class ClickUpService {
      */
     async createList(spaceId, data) {
         return this.makeRequest(async () => {
-            const response = await this.client.post(`/space/${spaceId}/list`, data);
+            // 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);
             return response.data;
         });
     }

package/package.json CHANGED Viewed

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