@taazkareem/clickup-mcp-server 0.4.69 → 0.4.71

package/README.md

@@ -3,35 +3,49 @@
 # MCP Server
 A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.
 
-> 🚧 **Status Update:** -Improved task name matching and fixed workspace hierarchy display
+> 🚧 **Status Update:** -Added get_task_comments tool -Improved task name matching -Fixed workspace hierarchy display
 
 <a href="https://glama.ai/mcp/servers/iwjvs2zy63">
   <img width="380" height="200" src="https://glama.ai/mcp/servers/iwjvs2zy63/badge" alt="ClickUp Server MCP server" />
 </a>
 
-## Quick Start
-
-Directions for use with Cursor Composer Agent:
+## Setup
 
 1. Get your credentials:
    - ClickUp API key from [ClickUp Settings](https://app.clickup.com/settings/apps)
    - Team ID from your ClickUp workspace URL
-2. Go to Features in settings (or MCP Servers depending on version)
-3. Add under MCP Servers:
-```bash
-npx -y @taazkareem/clickup-mcp-server@latest \
-  --env CLICKUP_API_KEY=your_api_key_here \
-  --env CLICKUP_TEAM_ID=your_team_id_here
-```
-4. Replace the credentials and click Save
-5. Use Natural Language to interact with your ClickUp Workspace!
-
+2. Choose either hosted installation (sends webhooks) or NPX installation (downloads to local path and installs dependencies)
 
-## Smithery Installation
+## Smithery Installation (Quick Start)
 
 [![smithery badge](https://smithery.ai/badge/@TaazKareem/clickup-mcp-server)](https://smithery.ai/server/@TaazKareem/clickup-mcp-server)
 
-The server is also hosted on Smithery. There, you can preview the available tools or copy the commands to run on your specific client app.
+The server is hosted on Smithery. There, you can preview the available tools or copy the commands to run on your specific client app. 
+
+
+## NPX Installation
+
+Add this entry to your client's MCP settings JSON file:
+
+{
+  "mcpServers": {
+    "ClickUp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@taazkareem/clickup-mcp-server@latest"
+      ],
+      "env": {
+        "CLICKUP_API_KEY": "your-api-key",
+        "CLICKUP_TEAM_ID": "your-team-id"
+      }
+    }
+  }
+}
+
+-OR- Use this npx command:
+
+`npx -y @taazkareem/clickup-mcp-server@latest`
 
 ## Features
 
@@ -63,8 +77,9 @@ The server is also hosted on Smithery. There, you can preview the available tool
 | [create_bulk_tasks](docs/api-reference.md#task-management) | Create multiple tasks | `tasks[]` |
 | [update_task](docs/api-reference.md#task-management) | Modify task | `taskId`/`taskName` |
 | [update_bulk_tasks](docs/api-reference.md#task-management) | Update multiple tasks | `tasks[]` with IDs or names |
-| [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` |
+| [get_tasks](docs/api-reference.md#task-management) | Get tasks from list | `listId`/`listName` |
+| [get_task](docs/api-reference.md#task-management) | Get task details | `taskId`/`taskName` |
+| [get_task_comments](docs/api-reference.md#task-management) | Get comments on a task | `taskId`/`taskName` |
 | [delete_task](docs/api-reference.md#task-management) | Remove task | `taskId`/`taskName` |
 | [delete_bulk_tasks](docs/api-reference.md#task-management) | Remove multiple tasks | `tasks[]` with IDs or names |
 | [move_task](docs/api-reference.md#task-management) | Move task | `taskId`/`taskName`, `listId`/`listName` |
@@ -101,6 +116,10 @@ The server provides clear error messages for:
 - API errors
 - Rate limiting
 
+## Sponsor Message
+
+When using this server, you may occasionally see a small sponsor message with a link to this repository included in tool responses. I hope you can support the project!
+
 ## Support the Developer
 
 If you find this project useful, please consider supporting
@@ -122,4 +141,3 @@ or brands owned by third parties. The use of such APIs or references does not im
 any affiliation with or endorsement by the respective companies. All trademarks and 
 brand names are the property of their respective owners. This project is an independent
 work and is not officially associated with or sponsored by any third-party company mentioned.
-

package/build/config.js

@@ -22,11 +22,14 @@ for (let i = 0; i < args.length; i++) {
 const configuration = {
     clickupApiKey: envArgs.clickupApiKey || process.env.CLICKUP_API_KEY || '',
     clickupTeamId: envArgs.clickupTeamId || process.env.CLICKUP_TEAM_ID || '',
+    enableSponsorMessage: process.env.ENABLE_SPONSOR_MESSAGE === 'true' || false,
+    sponsorUrl: process.env.SPONSOR_URL || 'https://github.com/sponsors/taazkareem'
 };
-// Validate all required variables are present
-const missingEnvVars = Object.entries(configuration)
-    .filter(([_, value]) => !value)
-    .map(([key]) => key);
+// Validate only the required variables are present
+const requiredVars = ['clickupApiKey', 'clickupTeamId'];
+const missingEnvVars = requiredVars
+    .filter(key => !configuration[key])
+    .map(key => key);
 if (missingEnvVars.length > 0) {
     throw new Error(`Missing required environment variables: ${missingEnvVars.join(', ')}`);
 }

package/build/index.js

@@ -10,7 +10,7 @@
  * Task Management:
  * - Create, update, move and duplicate tasks with rich description support
  * - Find tasks by name with smart disambiguation
- * - Bulk task creation for efficient workflow setup
+ * - Optimized bulk task operations with concurrent processing
  * - Comprehensive filtering and sorting options
  *
  * Workspace Organization:

package/build/mcp-tools.js

@@ -0,0 +1,64 @@
+import { Logger } from "./logger.js";
+// Create a logger instance
+const logger = new Logger('MCPTools');
+/**
+ * Register a handler for a tool that may receive JSON string parameters
+ * This wrapper ensures that array and object parameters are properly parsed
+ *
+ * @param server MCP Server instance
+ * @param name Tool name
+ * @param handler Handler function
+ */
+export function registerToolHandler(server, name, handler) {
+    // Create a wrapper handler that pre-processes parameters
+    const wrappedHandler = async (params) => {
+        logger.debug(`Processing parameters for tool ${name}`, { params });
+        try {
+            // Process the parameters before passing them to the actual handler
+            const processedParams = {};
+            // Process each parameter - try to parse strings that might be JSON
+            for (const [key, value] of Object.entries(params)) {
+                if (typeof value === 'string') {
+                    try {
+                        // Check if this might be a JSON array or object
+                        if ((value.startsWith('[') && value.endsWith(']')) ||
+                            (value.startsWith('{') && value.endsWith('}'))) {
+                            try {
+                                processedParams[key] = JSON.parse(value);
+                                logger.debug(`Parsed JSON parameter: ${key}`, { original: value, parsed: processedParams[key] });
+                            }
+                            catch (parseError) {
+                                // If parsing fails, use the original string
+                                processedParams[key] = value;
+                                logger.debug(`Failed to parse JSON for parameter: ${key}, using original`, { error: parseError.message });
+                            }
+                        }
+                        else {
+                            processedParams[key] = value;
+                        }
+                    }
+                    catch (error) {
+                        // If there's any error, use the original value
+                        processedParams[key] = value;
+                        logger.debug(`Error processing parameter: ${key}`, { error: error.message });
+                    }
+                }
+                else {
+                    // Non-string values are used as-is
+                    processedParams[key] = value;
+                }
+            }
+            logger.debug(`Processed parameters for tool ${name}`, { processedParams });
+            // Call the original handler with processed parameters
+            return handler(processedParams);
+        }
+        catch (error) {
+            logger.error(`Error in wrapped handler for tool ${name}:`, { error: error.stack || error.message });
+            throw error;
+        }
+    };
+    // Use setRequestHandler to register the wrapped handler
+    logger.info(`Registering wrapped handler for tool: ${name}`);
+    // Override the tool's handler in the CallTool switch statement
+    // The server.ts file will use the switch case to call this handler
+}

package/build/server.js

@@ -1,7 +1,7 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { workspaceHierarchyTool, handleGetWorkspaceHierarchy } from "./tools/workspace.js";
-import { createTaskTool, handleCreateTask, updateTaskTool, handleUpdateTask, moveTaskTool, handleMoveTask, duplicateTaskTool, handleDuplicateTask, getTaskTool, getTasksTool, handleGetTasks, deleteTaskTool, handleDeleteTask, createBulkTasksTool, handleCreateBulkTasks, updateBulkTasksTool, handleUpdateBulkTasks, moveBulkTasksTool, handleMoveBulkTasks, deleteBulkTasksTool, handleDeleteBulkTasks, getTaskCommentsTool, handleGetTaskComments } from "./tools/task.js";
+import { createTaskTool, handleCreateTask, updateTaskTool, handleUpdateTask, moveTaskTool, handleMoveTask, duplicateTaskTool, handleDuplicateTask, getTaskTool, getTasksTool, handleGetTasks, deleteTaskTool, handleDeleteTask, getTaskCommentsTool, handleGetTaskComments, createBulkTasksTool, handleCreateBulkTasks, updateBulkTasksTool, handleUpdateBulkTasks, moveBulkTasksTool, handleMoveBulkTasks, deleteBulkTasksTool, handleDeleteBulkTasks } from "./tools/task.js";
 import { createListTool, handleCreateList, createListInFolderTool, handleCreateListInFolder, getListTool, handleGetList, updateListTool, handleUpdateList, deleteListTool, handleDeleteList } from "./tools/list.js";
 import { createFolderTool, handleCreateFolder, getFolderTool, handleGetFolder, updateFolderTool, handleUpdateFolder, deleteFolderTool, handleDeleteFolder } from "./tools/folder.js";
 import { Logger } from "./logger.js";
@@ -40,11 +40,11 @@ export function configureServer() {
                 moveTaskTool,
                 duplicateTaskTool,
                 deleteTaskTool,
+                getTaskCommentsTool,
                 createBulkTasksTool,
                 updateBulkTasksTool,
                 moveBulkTasksTool,
                 deleteBulkTasksTool,
-                getTaskCommentsTool,
                 createListTool,
                 createListInFolderTool,
                 getListTool,
@@ -87,6 +87,8 @@ export function configureServer() {
                     return handleGetTasks(params);
                 case "delete_task":
                     return handleDeleteTask(params);
+                case "get_task_comments":
+                    return handleGetTaskComments(params);
                 case "create_bulk_tasks":
                     return handleCreateBulkTasks(params);
                 case "update_bulk_tasks":
@@ -95,8 +97,6 @@ export function configureServer() {
                     return handleMoveBulkTasks(params);
                 case "delete_bulk_tasks":
                     return handleDeleteBulkTasks(params);
-                case "get_task_comments":
-                    return handleGetTaskComments(params);
                 case "create_list":
                     return handleCreateList(params);
                 case "create_list_in_folder":