@taazkareem/clickup-mcp-server 0.3.0 → 0.4.1

package/README.md

@@ -16,18 +16,24 @@ A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI appl
   - Flexible identification using IDs or names
 
 - ✨ **Task Operations**
-  - Create and update tasks
+  - Create single or bulk tasks
   - Move tasks between lists
   - Duplicate tasks
   - Set priorities and due dates
   - Assign team members
 
 - 📊 **Information Retrieval**
-  - Get spaces and lists with their IDs
+  - Get complete hierarchy of spaces, folders, and lists with IDs
   - List available statuses
   - Find items by name (case-insensitive)
   - View task relationships
 
+- 🔍 **Smart Name Resolution**
+  - Use names instead of IDs for lists and folders
+  - Global search across all spaces
+  - Case-insensitive matching
+  - Automatic location of items
+
 - 📝 **AI Integration**
   - Generate task descriptions with AI
   - Summarize tasks and analyze priorities
@@ -81,17 +87,20 @@ You can get these values from:
 
 ### Available Tools
 
-1. **list_spaces**
-   - Lists all spaces and their lists with IDs
+1. **workspace_hierarchy**
+   - Lists complete hierarchy of the ClickUp workspace
+   - Shows spaces, folders, and lists with their IDs
    - Shows available statuses for each list
+   - Provides a tree view of your workspace organization
    - No parameters required
 
 2. **create_task**
    - Creates a new task in ClickUp
    - Required parameters:
-     - `listId`: ID of the list to create the task in
      - `name`: Name of the task
    - Optional parameters:
+     - `listId`: ID of the list (optional if listName provided)
+     - `listName`: Name of the list (optional if listId provided)
      - `description`: Task description
      - `status`: Task status
      - `priority`: Priority level (1-4)
@@ -101,7 +110,6 @@ You can get these values from:
 3. **create_bulk_tasks**
    - Creates multiple tasks simultaneously in a list
    - Required parameters:
-     - `listId`: ID of the list to create the tasks in
      - `tasks`: Array of task objects, each containing:
        - `name`: Name of the task (required)
        - `description`: Task description (optional)
@@ -109,6 +117,9 @@ You can get these values from:
        - `priority`: Priority level 1-4 (optional)
        - `dueDate`: Due date ISO string (optional)
        - `assignees`: Array of user IDs (optional)
+   - Optional parameters:
+     - `listId`: ID of the list (optional if listName provided)
+     - `listName`: Name of the list (optional if listId provided)
 
 4. **create_list**
    - Creates a new list in a space
@@ -147,13 +158,17 @@ You can get these values from:
    - Moves a task to a different list
    - Required parameters:
      - `taskId`: ID of the task to move
-     - `listId`: ID of the destination list
+   - Optional parameters:
+     - `listId`: ID of destination list (optional if listName provided)
+     - `listName`: Name of destination list (optional if listId provided)
 
 8. **duplicate_task**
    - Creates a copy of a task in a specified list
    - Required parameters:
      - `taskId`: ID of the task to duplicate
-     - `listId`: ID of the destination list
+   - Optional parameters:
+     - `listId`: ID of destination list (optional if listName provided)
+     - `listName`: Name of destination list (optional if listId provided)
 
 9. **update_task**
    - Updates an existing task
@@ -231,4 +246,4 @@ Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md)
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. 
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/build/config.js

@@ -1,8 +1,13 @@
 import dotenv from 'dotenv';
 // Load environment variables from .env file
 dotenv.config();
+console.log('Environment variables received:', {
+    CLICKUP_API_KEY: process.env.CLICKUP_API_KEY,
+    TEAM_ID: process.env.TEAM_ID
+});
 // Parse command line arguments for --env flags
 const args = process.argv.slice(2);
+console.log('Command line arguments:', args);
 const envArgs = {};
 for (let i = 0; i < args.length; i++) {
     if (args[i] === '--env' && i + 1 < args.length) {
@@ -14,10 +19,12 @@ for (let i = 0; i < args.length; i++) {
         i++; // Skip the next argument since we used it
     }
 }
+console.log('Parsed environment arguments:', envArgs);
 const configuration = {
     clickupApiKey: envArgs.clickupApiKey || process.env.CLICKUP_API_KEY || '',
-    teamId: envArgs.teamId || process.env.TEAM_ID || '',
+    teamId: envArgs.teamId || process.env.TEAM_ID || ''
 };
+console.log('Final configuration:', configuration);
 // Check for missing environment variables
 const missingEnvVars = Object.entries(configuration)
     .filter(([_, value]) => !value)

package/build/handlers/prompts.js

@@ -0,0 +1,25 @@
+import { getAllTasks } from '../utils/resolvers.js';
+export async function handleSummarizeTasks(clickup, teamId) {
+    const { tasks } = await getAllTasks(clickup, teamId);
+    let output = "Summarized Tasks:\n\n";
+    for (const task of tasks) {
+        output += `- ${task.name}: ${task.description}\n`;
+    }
+    return output;
+}
+export async function handleAnalyzeTaskPriorities(clickup, teamId) {
+    const { tasks } = await getAllTasks(clickup, teamId);
+    const priorities = tasks.map(task => task.priority?.priority);
+    const uniquePriorities = [...new Set(priorities.filter(p => p !== undefined))];
+    const priorityCounts = uniquePriorities.map(priority => ({
+        priority,
+        count: priorities.filter(p => p === priority).length
+    }));
+    let output = "Task Priorities Analysis:\n\n";
+    output += "Available Priorities: " + uniquePriorities.join(', ') + "\n\n";
+    output += "Priority Counts:\n";
+    for (const priority of priorityCounts) {
+        output += `- Priority ${priority.priority}: ${priority.count}\n`;
+    }
+    return output;
+}

package/build/handlers/tools.js

@@ -0,0 +1,38 @@
+import { resolveListId } from '../utils/resolvers.js';
+export async function handleWorkspaceHierarchy(clickup, teamId) {
+    const spaces = await clickup.getSpaces(teamId);
+    const allLists = await clickup.getAllLists(teamId);
+    let output = "ClickUp Workspace Hierarchy:\n\n";
+    for (const space of spaces) {
+        output += `Space: ${space.name} (ID: ${space.id})\n`;
+        const folders = await clickup.getFolders(space.id);
+        for (const folder of folders) {
+            output += `  ├─ Folder: ${folder.name} (ID: ${folder.id})\n`;
+            const folderLists = folder.lists || [];
+            for (const list of folderLists) {
+                const { statuses } = await clickup.getTasks(list.id);
+                output += `  │  └─ List: ${list.name} (ID: ${list.id})\n`;
+                output += `  │     Available Statuses: ${statuses.join(', ')}\n`;
+            }
+        }
+        const spaceLists = allLists.filter(list => list.space &&
+            list.space.id === space.id &&
+            !folders.some(folder => folder.lists?.some(fl => fl.id === list.id)));
+        if (spaceLists.length > 0) {
+            output += "  ├─ Lists (not in folders):\n";
+            for (const list of spaceLists) {
+                const { statuses } = await clickup.getTasks(list.id);
+                output += `  │  └─ List: ${list.name} (ID: ${list.id})\n`;
+                output += `  │     Available Statuses: ${statuses.join(', ')}\n`;
+            }
+        }
+        output += "\n";
+    }
+    return output;
+}
+export async function handleCreateTask(clickup, teamId, args) {
+    const listId = await resolveListId(clickup, teamId, args.listId, args.listName);
+    const { listId: _, listName: __, ...taskData } = args;
+    return await clickup.createTask(listId, taskData);
+}
+// Add other handler functions for each tool... 

package/build/index.js

@@ -1,36 +1,31 @@
 #!/usr/bin/env node
-/**
- * This is a template MCP server that implements a simple ClickUp task management system.
- * It demonstrates core MCP concepts like resources, tools, and prompts by allowing:
- * - Listing ClickUp tasks as resources
- * - Reading individual ClickUp tasks
- * - Creating new ClickUp tasks via a tool
- * - Updating existing ClickUp tasks via a tool
- * - Summarizing all ClickUp tasks via a prompt
- * - Analyzing task priorities via a prompt
- * - Generating detailed descriptions for tasks via a prompt
- */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { ClickUpService } from "./services/clickup.js";
 import config from "./config.js";
-/**
- * Simple in-memory storage for notes.
- * In a real implementation, this would likely be backed by a database.
- */
-const notes = {
-    "1": { title: "First Note", content: "This is note 1" },
-    "2": { title: "Second Note", content: "This is note 2" }
-};
+import { handleWorkspaceHierarchy, handleCreateTask } from "./handlers/tools.js";
+import { handleSummarizeTasks, handleAnalyzeTaskPriorities } from "./handlers/prompts.js";
+import { getAllTasks } from "./utils/resolvers.js";
+console.log('Server starting up...');
+console.log('Config loaded:', {
+    clickupApiKey: config.clickupApiKey ? '***' : 'missing',
+    teamId: config.teamId || 'missing'
+});
 // Initialize ClickUp service
-const clickup = ClickUpService.initialize(config.clickupApiKey);
-/**
- * Create an MCP server with capabilities for resources (to list/read ClickUp tasks),
- * tools (to create/update ClickUp tasks), and prompts (to summarize/analyze ClickUp tasks).
- */
+let clickup;
+try {
+    console.log('Initializing ClickUp service...');
+    clickup = ClickUpService.initialize(config.clickupApiKey);
+    console.log('ClickUp service initialized successfully');
+}
+catch (error) {
+    console.error("Failed to initialize ClickUp service:", error);
+    process.exit(1);
+}
+console.log('Creating MCP server...');
 const server = new Server({
-    name: "clickup-mcp-server",
+    name: "clickup",
     version: "0.1.0",
 }, {
     capabilities: {
@@ -39,40 +34,31 @@ const server = new Server({
         prompts: {},
     },
 });
+console.log('MCP server created');
 /**
  * Handler for listing available ClickUp tasks as resources.
- * Each task is exposed as a resource with:
- * - A clickup:// URI scheme
- * - JSON MIME type
- * - Human readable name and description (including the task name and description)
  */
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    console.log('Handling ListResources request');
     try {
-        const spaces = await clickup.getSpaces(config.teamId);
-        const resources = [];
-        for (const space of spaces) {
-            const lists = await clickup.getLists(space.id);
-            for (const list of lists) {
-                const { tasks } = await clickup.getTasks(list.id);
-                resources.push(...tasks.map((task) => ({
-                    uri: `clickup://task/${task.id}`,
-                    mimeType: "application/json",
-                    name: task.name,
-                    description: task.description || `Task in ${list.name} (${space.name})`,
-                    tags: []
-                })));
-            }
-        }
-        return { resources };
+        const { tasks, spaces } = await getAllTasks(clickup, config.teamId);
+        return {
+            resources: tasks.map(task => ({
+                uri: `clickup://task/${task.id}`,
+                mimeType: "application/json",
+                name: task.name,
+                description: task.description || `Task in ${task.list.name} (${task.space.name})`,
+                tags: []
+            }))
+        };
     }
     catch (error) {
-        console.error('Error listing resources:', error);
+        console.error('Error in ListResources:', error);
         throw error;
     }
 });
 /**
  * Handler for reading the contents of a specific ClickUp task.
- * Takes a clickup:// URI and returns the task content as JSON.
  */
 server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     try {
@@ -94,15 +80,15 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     }
 });
 /**
- * Handler that lists available tools.
- * Exposes tools for listing spaces, creating tasks, and updating tasks.
+ * Handler for listing available tools.
  */
 server.setRequestHandler(ListToolsRequestSchema, async () => {
+    console.log('Handling ListTools request');
     return {
         tools: [
             {
-                name: "list_spaces",
-                description: "List all spaces and their lists with IDs",
+                name: "workspace_hierarchy",
+                description: "List complete hierarchy of the ClickUp workspace",
                 inputSchema: {
                     type: "object",
                     properties: {},
@@ -117,7 +103,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     properties: {
                         listId: {
                             type: "string",
-                            description: "ID of the list to create the task in"
+                            description: "ID of the list to create the task in (optional if listName is provided)"
+                        },
+                        listName: {
+                            type: "string",
+                            description: "Name of the list to create the task in (optional if listId is provided)"
                         },
                         name: {
                             type: "string",
@@ -140,7 +130,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             description: "Due date of the task (ISO string)"
                         }
                     },
-                    required: ["listId", "name"]
+                    required: ["name"]
                 }
             },
             {
@@ -151,7 +141,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     properties: {
                         listId: {
                             type: "string",
-                            description: "ID of the list to create the tasks in"
+                            description: "ID of the list to create the tasks in (optional if listName is provided)"
+                        },
+                        listName: {
+                            type: "string",
+                            description: "Name of the list to create the tasks in (optional if listId is provided)"
                         },
                         tasks: {
                             type: "array",
@@ -177,7 +171,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                                     },
                                     dueDate: {
                                         type: "string",
-                                        description: "Due date of the task (ISO string)"
+                                        description: "Due date (ISO string)"
                                     },
                                     assignees: {
                                         type: "array",
@@ -191,7 +185,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             }
                         }
                     },
-                    required: ["listId", "tasks"]
+                    required: ["tasks"]
                 }
             },
             {
@@ -312,10 +306,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         listId: {
                             type: "string",
-                            description: "ID of the destination list"
+                            description: "ID of the destination list (optional if listName is provided)"
+                        },
+                        listName: {
+                            type: "string",
+                            description: "Name of the destination list (optional if listId is provided)"
                         }
                     },
-                    required: ["taskId", "listId"]
+                    required: ["taskId"]
                 }
             },
             {
@@ -330,10 +328,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         listId: {
                             type: "string",
-                            description: "ID of the list to create the duplicate in"
+                            description: "ID of the destination list (optional if listName is provided)"
+                        },
+                        listName: {
+                            type: "string",
+                            description: "Name of the destination list (optional if listId is provided)"
                         }
                     },
-                    required: ["taskId", "listId"]
+                    required: ["taskId"]
                 }
             },
             {
@@ -374,36 +376,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     };
 });
 /**
- * Handler for the CallToolRequestSchema.
- * Handles the execution of tools like listing spaces, creating tasks, and updating tasks.
+ * Handler for executing tools.
  */
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     try {
         switch (request.params.name) {
-            case "list_spaces": {
-                const spaces = await clickup.getSpaces(config.teamId);
-                const allLists = await clickup.getAllLists(config.teamId);
-                let output = "Available Spaces and Lists:\n\n";
-                for (const space of spaces) {
-                    output += `Space: ${space.name} (ID: ${space.id})\n`;
-                    const spaceLists = allLists.filter(list => list.space.id === space.id);
-                    for (const list of spaceLists) {
-                        const { statuses } = await clickup.getTasks(list.id);
-                        output += `  └─ List: ${list.name} (ID: ${list.id})\n`;
-                        output += `    Available Statuses: ${statuses.join(', ')}\n`;
-                    }
-                    output += "\n";
-                }
-                // Add lists without spaces at the end
-                const listsWithoutSpace = allLists.filter(list => !list.space);
-                if (listsWithoutSpace.length > 0) {
-                    output += "Lists without assigned spaces:\n";
-                    for (const list of listsWithoutSpace) {
-                        const { statuses } = await clickup.getTasks(list.id);
-                        output += `  └─ List: ${list.name} (ID: ${list.id})\n`;
-                        output += `    Available Statuses: ${statuses.join(', ')}\n`;
-                    }
-                }
+            case "workspace_hierarchy": {
+                const output = await handleWorkspaceHierarchy(clickup, config.teamId);
                 return {
                     content: [{
                             type: "text",
@@ -413,11 +392,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "create_task": {
                 const args = request.params.arguments;
-                if (!args.listId || !args.name) {
-                    throw new Error("listId and name are required");
-                }
-                const { listId, ...taskData } = args;
-                const task = await clickup.createTask(listId, taskData);
+                const task = await handleCreateTask(clickup, config.teamId, args);
                 return {
                     content: [{
                             type: "text",
@@ -427,10 +402,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "create_bulk_tasks": {
                 const args = request.params.arguments;
-                if (!args.listId || !args.tasks || !args.tasks.length) {
-                    throw new Error("listId and at least one task are required");
+                let listId = args.listId;
+                if (!listId && args.listName) {
+                    const result = await clickup.findListByNameGlobally(config.teamId, args.listName);
+                    if (!result) {
+                        throw new Error(`List with name "${args.listName}" not found`);
+                    }
+                    listId = result.list.id;
                 }
-                const { listId, tasks } = args;
+                if (!listId) {
+                    throw new Error("Either listId or listName is required");
+                }
+                if (!args.tasks || !args.tasks.length) {
+                    throw new Error("At least one task is required");
+                }
+                const { listId: _, listName: __, tasks } = args;
                 const createdTasks = await clickup.createBulkTasks(listId, { tasks });
                 return {
                     content: [{
@@ -444,6 +430,29 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (!args.name) {
                     throw new Error("name is required");
                 }
+                // If folder is specified, create list in folder
+                if (args.folderName || args.folderId) {
+                    let folderId = args.folderId;
+                    if (!folderId && args.folderName) {
+                        const result = await clickup.findFolderByNameGlobally(config.teamId, args.folderName);
+                        if (!result) {
+                            throw new Error(`Folder with name "${args.folderName}" not found`);
+                        }
+                        folderId = result.folder.id;
+                    }
+                    if (!folderId) {
+                        throw new Error("Either folderId or folderName must be provided");
+                    }
+                    const { spaceId: _, spaceName: __, folderName: ___, folderId: ____, ...listData } = args;
+                    const list = await clickup.createListInFolder(folderId, listData);
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Created list ${list.id}: ${list.name} in folder`
+                            }]
+                    };
+                }
+                // Otherwise, create list in space
                 let spaceId = args.spaceId;
                 if (!spaceId && args.spaceName) {
                     const space = await clickup.findSpaceByName(config.teamId, args.spaceName);
@@ -455,7 +464,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (!spaceId) {
                     throw new Error("Either spaceId or spaceName must be provided");
                 }
-                const { spaceId: _, spaceName: __, ...listData } = args;
+                const { spaceId: _, spaceName: __, folderName: ___, folderId: ____, ...listData } = args;
                 const list = await clickup.createList(spaceId, listData);
                 return {
                     content: [{
@@ -496,58 +505,78 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 }
                 let folderId = args.folderId;
                 if (!folderId && args.folderName) {
-                    let spaceId = args.spaceId;
-                    if (!spaceId && args.spaceName) {
-                        const space = await clickup.findSpaceByName(config.teamId, args.spaceName);
-                        if (!space) {
-                            throw new Error(`Space with name "${args.spaceName}" not found`);
-                        }
-                        spaceId = space.id;
-                    }
-                    if (!spaceId) {
-                        throw new Error("Either spaceId or spaceName must be provided when using folderName");
-                    }
-                    const folder = await clickup.findFolderByName(spaceId, args.folderName);
-                    if (!folder) {
+                    const result = await clickup.findFolderByNameGlobally(config.teamId, args.folderName);
+                    if (!result) {
                         throw new Error(`Folder with name "${args.folderName}" not found`);
                     }
-                    folderId = folder.id;
+                    folderId = result.folder.id;
                 }
                 if (!folderId) {
-                    throw new Error("Either folderId or folderName (with space information) must be provided");
+                    throw new Error("Either folderId or folderName is required");
                 }
-                const { folderId: _, folderName: __, spaceId: ___, spaceName: ____, ...listData } = args;
-                const list = await clickup.createListInFolder(folderId, listData);
-                return {
-                    content: [{
-                            type: "text",
-                            text: `Created list ${list.id}: ${list.name} in folder`
-                        }]
+                const listData = {
+                    name: args.name,
+                    content: args.content,
+                    status: args.status
                 };
+                try {
+                    const list = await clickup.createListInFolder(folderId, listData);
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Created list ${list.id}: ${list.name} in folder`
+                            }]
+                    };
+                }
+                catch (error) {
+                    throw new Error(`Failed to create list: ${error.message}`);
+                }
             }
             case "move_task": {
                 const args = request.params.arguments;
-                if (!args.taskId || !args.listId) {
-                    throw new Error("taskId and listId are required");
+                if (!args.taskId) {
+                    throw new Error("taskId is required");
+                }
+                let listId = args.listId;
+                if (!listId && args.listName) {
+                    const result = await clickup.findListByNameGlobally(config.teamId, args.listName);
+                    if (!result) {
+                        throw new Error(`List with name "${args.listName}" not found`);
+                    }
+                    listId = result.list.id;
+                }
+                if (!listId) {
+                    throw new Error("Either listId or listName is required");
                 }
-                const task = await clickup.moveTask(args.taskId, args.listId);
+                const task = await clickup.moveTask(args.taskId, listId);
                 return {
                     content: [{
                             type: "text",
-                            text: `Moved task ${task.id} to list ${args.listId}`
+                            text: `Moved task ${task.id} to list ${listId}`
                         }]
                 };
             }
             case "duplicate_task": {
                 const args = request.params.arguments;
-                if (!args.taskId || !args.listId) {
-                    throw new Error("taskId and listId are required");
+                if (!args.taskId) {
+                    throw new Error("taskId is required");
                 }
-                const task = await clickup.duplicateTask(args.taskId, args.listId);
+                let listId = args.listId;
+                if (!listId && args.listName) {
+                    const result = await clickup.findListByNameGlobally(config.teamId, args.listName);
+                    if (!result) {
+                        throw new Error(`List with name "${args.listName}" not found`);
+                    }
+                    listId = result.list.id;
+                }
+                if (!listId) {
+                    throw new Error("Either listId or listName is required");
+                }
+                const task = await clickup.duplicateTask(args.taskId, listId);
                 return {
                     content: [{
                             type: "text",
-                            text: `Duplicated task ${args.taskId} to new task ${task.id} in list ${args.listId}`
+                            text: `Duplicated task ${args.taskId} to new task ${task.id} in list ${listId}`
                         }]
                 };
             }
@@ -556,8 +585,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (!args.taskId) {
                     throw new Error("taskId is required");
                 }
-                const { taskId, ...updateData } = args;
-                const task = await clickup.updateTask(taskId, updateData);
+                const dueDate = args.due_date ? new Date(args.due_date).getTime() : undefined;
+                const task = await clickup.updateTask(args.taskId, {
+                    name: args.name,
+                    description: args.description,
+                    status: args.status,
+                    priority: args.priority,
+                    due_date: dueDate
+                });
                 return {
                     content: [{
                             type: "text",
@@ -570,147 +605,79 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
     }
     catch (error) {
-        console.error('Error handling tool call:', error);
+        console.error('Error executing tool:', error);
         throw error;
     }
 });
 /**
- * Add handlers for listing and getting prompts.
- * Prompts include summarizing tasks, analyzing priorities, and generating task descriptions.
+ * Handler for listing available prompts.
  */
 server.setRequestHandler(ListPromptsRequestSchema, async () => {
     return {
         prompts: [
             {
                 name: "summarize_tasks",
-                description: "Summarize all tasks in a list",
-            },
-            {
-                name: "analyze_priorities",
-                description: "Analyze task priorities and suggest optimizations",
+                description: "Summarize all ClickUp tasks"
             },
             {
-                name: "generate_description",
-                description: "Generate a detailed description for a task",
+                name: "analyze_task_priorities",
+                description: "Analyze task priorities"
             }
         ]
     };
 });
+/**
+ * Handler for getting a specific prompt.
+ */
 server.setRequestHandler(GetPromptRequestSchema, async (request) => {
     try {
         switch (request.params.name) {
             case "summarize_tasks": {
-                const spaces = await clickup.getSpaces(config.teamId);
-                const tasks = [];
-                // Gather all tasks
-                for (const space of spaces) {
-                    const lists = await clickup.getLists(space.id);
-                    for (const list of lists) {
-                        const { tasks: listTasks } = await clickup.getTasks(list.id);
-                        tasks.push(...listTasks.map((task) => ({
-                            type: "resource",
-                            resource: {
-                                uri: `clickup://task/${task.id}`,
-                                mimeType: "application/json",
-                                text: JSON.stringify(task, null, 2)
-                            }
-                        })));
-                    }
-                }
+                const output = await handleSummarizeTasks(clickup, config.teamId);
                 return {
-                    messages: [
-                        {
-                            role: "user",
-                            content: {
-                                type: "text",
-                                text: "Please provide a summary of the following ClickUp tasks:"
-                            }
-                        },
-                        ...tasks.map(task => ({
-                            role: "user",
-                            content: task
-                        })),
-                        {
-                            role: "user",
-                            content: {
-                                type: "text",
-                                text: "Please provide:\n1. A high-level overview of all tasks\n2. Group them by status\n3. Highlight any urgent or high-priority items\n4. Suggest any task dependencies or relationships"
-                            }
-                        }
-                    ]
-                };
-            }
-            case "analyze_priorities": {
-                const spaces = await clickup.getSpaces(config.teamId);
-                const tasks = [];
-                for (const space of spaces) {
-                    const lists = await clickup.getLists(space.id);
-                    for (const list of lists) {
-                        const { tasks: listTasks } = await clickup.getTasks(list.id);
-                        tasks.push(...listTasks.map((task) => ({
-                            type: "resource",
-                            resource: {
-                                uri: `clickup://task/${task.id}`,
-                                mimeType: "application/json",
-                                text: JSON.stringify(task, null, 2)
-                            }
-                        })));
-                    }
-                }
-                return {
-                    messages: [
-                        {
-                            role: "user",
-                            content: {
-                                type: "text",
-                                text: "Please analyze the priorities of the following ClickUp tasks:"
-                            }
-                        },
-                        ...tasks.map(task => ({
-                            role: "user",
-                            content: task
-                        })),
-                        {
-                            role: "user",
-                            content: {
-                                type: "text",
-                                text: "Please provide:\n1. Analysis of current priority distribution\n2. Identify any misaligned priorities\n3. Suggest priority adjustments\n4. Recommend task sequencing based on priorities"
-                            }
-                        }
-                    ]
+                    content: [{
+                            type: "text",
+                            text: output
+                        }]
                 };
             }
-            case "generate_description": {
+            case "analyze_task_priorities": {
+                const output = await handleAnalyzeTaskPriorities(clickup, config.teamId);
                 return {
-                    messages: [
-                        {
-                            role: "user",
-                            content: {
-                                type: "text",
-                                text: "Please help me generate a detailed description for a ClickUp task. The description should include:\n1. Clear objective\n2. Success criteria\n3. Required resources\n4. Dependencies\n5. Potential risks\n\nPlease ask me about the task details."
-                            }
-                        }
-                    ]
+                    content: [{
+                            type: "text",
+                            text: output
+                        }]
                 };
             }
             default:
-                throw new Error("Unknown prompt");
+                throw new Error("Prompt not found");
         }
     }
     catch (error) {
-        console.error('Error handling prompt:', error);
+        console.error('Error getting prompt:', error);
         throw error;
     }
 });
-/**
- * Start the server using stdio transport.
- * This allows the server to communicate via standard input/output streams.
- */
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-}
-main().catch((error) => {
-    console.error("Server error:", error);
+// Start the server
+console.log('Setting up transport...');
+const transport = new StdioServerTransport();
+// Connect the server to the transport
+console.log('Connecting server to transport...');
+server.connect(transport).catch(error => {
+    console.error('Error connecting server to transport:', error);
     process.exit(1);
 });
+// Handle process signals
+process.on('SIGINT', () => {
+    console.log('Received SIGINT. Shutting down...');
+    transport.close();
+});
+process.on('SIGTERM', () => {
+    console.log('Received SIGTERM. Shutting down...');
+    transport.close();
+});
+// Prevent unhandled promise rejections from crashing the server
+process.on('unhandledRejection', (error) => {
+    console.error('Unhandled promise rejection:', error);
+});

package/build/services/clickup.js

@@ -110,6 +110,43 @@ export class ClickUpService {
         });
         return response.data;
     }
+    async findListByNameGlobally(teamId, listName) {
+        const spaces = await this.getSpaces(teamId);
+        for (const space of spaces) {
+            // Check lists in folders
+            const folders = await this.getFolders(space.id);
+            for (const folder of folders) {
+                const folderList = folder.lists?.find(list => list.name.toLowerCase() === listName.toLowerCase());
+                if (folderList) {
+                    return { list: folderList, space, folder };
+                }
+            }
+            // Check lists directly in space
+            const spaceLists = await this.getLists(space.id);
+            const spaceList = spaceLists.find(list => list.name.toLowerCase() === listName.toLowerCase());
+            if (spaceList) {
+                return { list: spaceList, space };
+            }
+        }
+        // Check lists without spaces
+        const allLists = await this.getAllLists(teamId);
+        const list = allLists.find(list => list.name.toLowerCase() === listName.toLowerCase());
+        if (list) {
+            return { list };
+        }
+        return null;
+    }
+    async findFolderByNameGlobally(teamId, folderName) {
+        const spaces = await this.getSpaces(teamId);
+        for (const space of spaces) {
+            const folders = await this.getFolders(space.id);
+            const folder = folders.find(folder => folder.name.toLowerCase() === folderName.toLowerCase());
+            if (folder) {
+                return { folder, space };
+            }
+        }
+        return null;
+    }
     async duplicateTask(taskId, listId) {
         const response = await this.client.post(`/task/${taskId}/duplicate`, {
             list: listId
@@ -123,8 +160,4 @@ export class ClickUpService {
         const response = await this.client.put(`/list/${listId}`, data);
         return response.data;
     }
-    async findListByName(spaceId, listName) {
-        const lists = await this.getLists(spaceId);
-        return lists.find(list => list.name.toLowerCase() === listName.toLowerCase()) || null;
-    }
 }

package/build/utils/resolvers.js

@@ -0,0 +1,48 @@
+export async function resolveListId(clickup, teamId, listId, listName) {
+    if (listId)
+        return listId;
+    if (!listName) {
+        throw new Error("Either listId or listName is required");
+    }
+    const result = await clickup.findListByNameGlobally(teamId, listName);
+    if (!result) {
+        throw new Error(`List with name "${listName}" not found`);
+    }
+    return result.list.id;
+}
+export async function resolveSpaceId(clickup, teamId, spaceId, spaceName) {
+    if (spaceId)
+        return spaceId;
+    if (!spaceName) {
+        throw new Error("Either spaceId or spaceName is required");
+    }
+    const space = await clickup.findSpaceByName(teamId, spaceName);
+    if (!space) {
+        throw new Error(`Space with name "${spaceName}" not found`);
+    }
+    return space.id;
+}
+export async function resolveFolderId(clickup, teamId, folderId, folderName) {
+    if (folderId)
+        return folderId;
+    if (!folderName) {
+        throw new Error("Either folderId or folderName is required");
+    }
+    const result = await clickup.findFolderByNameGlobally(teamId, folderName);
+    if (!result) {
+        throw new Error(`Folder with name "${folderName}" not found`);
+    }
+    return result.folder.id;
+}
+export async function getAllTasks(clickup, teamId) {
+    const spaces = await clickup.getSpaces(teamId);
+    const spacePromises = spaces.map(async (space) => {
+        const lists = await clickup.getLists(space.id);
+        const listPromises = lists.map(list => clickup.getTasks(list.id));
+        const listResults = await Promise.all(listPromises);
+        return listResults.flatMap(result => result.tasks);
+    });
+    const tasksPerSpace = await Promise.all(spacePromises);
+    const allTasks = tasksPerSpace.flat();
+    return { tasks: allTasks, spaces };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taazkareem/clickup-mcp-server",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",
@@ -41,7 +41,7 @@
   },
   "homepage": "https://github.com/taazkareem/clickup-mcp-server#readme",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "0.6.0",
+    "@modelcontextprotocol/sdk": "^1.4.1",
     "axios": "^1.6.7",
     "dotenv": "^16.4.1"
   },