@taazkareem/clickup-mcp-server 0.4.41 → 0.4.42

package/README.md

@@ -2,14 +2,6 @@
 
 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.
 
-## Quick Start
-```bash
-npx clickup-mcp-server --stdio --env CLICKUP_API_KEY=your_api_key_here --env TEAM_ID=your_team_id_here
-```
-That's it! No installation needed. Just replace the credentials with your own:
-- Get your API key from [ClickUp Settings](https://app.clickup.com/settings/apps)
-- Find your Team ID in your ClickUp workspace URL or settings
-
 ## Features
 
 - 🔄 **Resource Management**
@@ -51,44 +43,36 @@ That's it! No installation needed. Just replace the credentials with your own:
   - Secure API key management
   - Environment-based configuration
 
+## Installation
+
+### Using npx
+```bash
+npx @taazkareem/clickup-mcp-server
+```
+
+## Configuration
+
+1. Get your ClickUp API key from [ClickUp Settings](https://app.clickup.com/settings/apps)
+2. Create a `.env` file:
+```env
+CLICKUP_API_KEY=your_api_key_here
+TEAM_ID=your_team_id_here
+```
+
 ## Using with Cursor AI Composer Agent
 
-To add this server to Cursor AI Composer:
-
-1. Go to Features → MCP Servers in settings
-2. Paste this command:
-   ```bash
-   npx clickup-mcp-server --stdio --env CLICKUP_API_KEY=your_api_key_here --env TEAM_ID=your_team_id_here
-   ```
-3. Replace the credentials with your own
-4. Click 'Save'
-
-## Using with Roo Code (formerly Cline)
-
-To add this server to Roo Code:
-
-1. Open Roo Code (formerly Cline).
-2. Ask Roo Code to add the ClickUp MCP Server to your project. It should add this to your `cline_mcp_settings.json` file:
-   ```json
-   "clickup-mcp-server": {
-     "command": "npx",
-     "args": [
-       "clickup-mcp-server",
-       "--stdio"
-     ],
-     "env": {
-       "CLICKUP_API_KEY": "your_api_key_here",
-       "TEAM_ID": "your_team_id_here"
-     },
-     "disabled": false,
-     "alwaysAllow": []
-   }
-   ```
-4. Replace `your_api_key_here` and `your_team_id_here` with your actual ClickUp API key and Team ID.
-   **Note:** Do not use the example settings and credentials provided here; use your own.
-5. Save the `cline_mcp_settings.json` file.
+To add this server to Cursor AI Composer, follow these steps:
 
+1. Go to the Features section in the settings.
+2. Add the following command under MCP Servers:
 
+```bash
+npx -y @taazkareem/clickup-mcp-server --stdio \
+  --env CLICKUP_API_KEY=your_api_key_here \
+  --env TEAM_ID=your_team_id_here
+```
+3. Replace `your_api_key_here` and `your_team_id_here` with your actual ClickUp credentials.
+4. Click on 'Save' to add the server.
 
 > **Security Note**: Your API key will be stored securely and will not be exposed to AI models.
 
@@ -254,6 +238,3 @@ 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.
-
-## Support My Work! 👍
-Solana Wallet: GjtRksihd7SWQw7hJSCDMcTxPHbgpNs7xPW3nFubNjVM

package/build/config.js

@@ -1,23 +1,13 @@
 import dotenv from 'dotenv';
-// Function to format messages as JSON-RPC 2.0
-function logMessage(method, params) {
-    const jsonRpcMessage = {
-        jsonrpc: "2.0",
-        method,
-        params,
-        id: Date.now()
-    };
-    console.log(JSON.stringify(jsonRpcMessage));
-}
 // Load environment variables from .env file
 dotenv.config();
-logMessage('config.env.received', {
+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);
-logMessage('config.args.received', args);
+console.log('Command line arguments:', args);
 const envArgs = {};
 for (let i = 0; i < args.length; i++) {
     if (args[i] === '--env' && i + 1 < args.length) {
@@ -29,12 +19,12 @@ for (let i = 0; i < args.length; i++) {
         i++; // Skip the next argument since we used it
     }
 }
-logMessage('config.args.parsed', envArgs);
+console.log('Parsed environment arguments:', envArgs);
 const configuration = {
     clickupApiKey: envArgs.clickupApiKey || process.env.CLICKUP_API_KEY || '',
     teamId: envArgs.teamId || process.env.TEAM_ID || ''
 };
-logMessage('config.final', configuration);
+console.log('Final configuration:', configuration);
 // Check for missing environment variables
 const missingEnvVars = Object.entries(configuration)
     .filter(([_, value]) => !value)

package/build/handlers/prompts.js

@@ -1,28 +1,4 @@
-/**
- * Prompt handlers for ClickUp MCP server.
- * Implements handlers for AI-powered analysis and summarization of ClickUp data.
- * Each handler processes ClickUp data and returns formatted text output.
- * @module handlers/prompts
- */
 import { getAllTasks } from '../utils/resolvers.js';
-/**
- * Generates a summary of all tasks in the workspace
- * Lists each task with its name and description, providing a quick overview
- * of all work items across spaces and lists.
- *
- * @param clickup - ClickUp service instance for API operations
- * @param teamId - Team ID to fetch tasks for
- * @returns Promise resolving to formatted text summary of all tasks
- *
- * @example
- * Output format:
- * ```
- * Summarized Tasks:
- *
- * - Task Name 1: Description of first task
- * - Task Name 2: Description of second task
- * ```
- */
 export async function handleSummarizeTasks(clickup, teamId) {
     const { tasks } = await getAllTasks(clickup, teamId);
     let output = "Summarized Tasks:\n\n";
@@ -31,35 +7,6 @@ export async function handleSummarizeTasks(clickup, teamId) {
     }
     return output;
 }
-/**
- * Analyzes task priorities across the workspace
- * Provides a statistical breakdown of task priorities, showing the distribution
- * of priority levels and identifying potential workload patterns.
- *
- * @param clickup - ClickUp service instance for API operations
- * @param teamId - Team ID to analyze tasks for
- * @returns Promise resolving to formatted text analysis of task priorities
- *
- * @example
- * Output format:
- * ```
- * Task Priorities Analysis:
- *
- * Available Priorities: 1, 2, 3, 4
- *
- * Priority Counts:
- * - Priority 1: 5
- * - Priority 2: 3
- * - Priority 3: 8
- * - Priority 4: 2
- * ```
- *
- * Priority levels:
- * 1 - Urgent
- * 2 - High
- * 3 - Normal
- * 4 - Low
- */
 export async function handleAnalyzeTaskPriorities(clickup, teamId) {
     const { tasks } = await getAllTasks(clickup, teamId);
     const priorities = tasks.map(task => task.priority?.priority);

package/build/handlers/tools.js

@@ -1,311 +1,38 @@
-/**
- * Tool handlers for ClickUp MCP server.
- * Implements the business logic for each tool operation.
- * @module handlers/tools
- */
-import { resolveListId, resolveSpaceId, resolveFolderId } from '../utils/resolvers.js';
-import { logError } from '../utils/logger.js';
-/**
- * Handles the workspace_hierarchy tool request
- * Returns a formatted tree view of the ClickUp workspace structure
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID to fetch hierarchy for
- * @returns Promise resolving to MCP-formatted response
- */
+import { resolveListId } from '../utils/resolvers.js';
 export async function handleWorkspaceHierarchy(clickup, teamId) {
-    try {
-        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 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`;
-                }
+        }
+        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 {
-            content: [{
-                    type: 'text',
-                    text: output
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.workspace_hierarchy', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to fetch workspace hierarchy: ${errorMessage}`
-                }]
-        };
+        output += "\n";
     }
+    return output;
 }
-/**
- * Handles the create_task tool request
- * Creates a new task in the specified list
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID to create task in
- * @param args - Task creation arguments
- * @returns Promise resolving to MCP-formatted response
- */
 export async function handleCreateTask(clickup, teamId, args) {
-    try {
-        const listId = await resolveListId(clickup, teamId, args.listId, args.listName);
-        const { listId: _, listName: __, ...taskData } = args;
-        const task = await clickup.createTask(listId, taskData);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Successfully created task "${task.name}" (ID: ${task.id})`
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.create_task', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to create task: ${errorMessage}`
-                }]
-        };
-    }
-}
-/**
- * Handles the create_bulk_tasks tool request
- * Creates multiple tasks in the specified list
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID to create tasks in
- * @param args - Bulk task creation arguments
- * @returns Promise resolving to MCP-formatted response
- */
-export async function handleCreateBulkTasks(clickup, teamId, args) {
-    try {
-        const listId = await resolveListId(clickup, teamId, args.listId, args.listName);
-        const { listId: _, listName: __, tasks } = args;
-        const createdTasks = await Promise.all(tasks.map(taskData => clickup.createTask(listId, taskData)));
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Successfully created ${createdTasks.length} tasks in list ${listId}`
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.create_bulk_tasks', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to create bulk tasks: ${errorMessage}`
-                }]
-        };
-    }
-}
-/**
- * Handles the create_list tool request
- * Creates a new list in the specified space
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID to create list in
- * @param args - List creation arguments
- * @returns Promise resolving to MCP-formatted response
- */
-export async function handleCreateList(clickup, teamId, args) {
-    try {
-        const spaceId = await resolveSpaceId(clickup, teamId, args.spaceId, args.spaceName);
-        const { spaceId: _, spaceName: __, ...listData } = args;
-        const list = await clickup.createList(spaceId, listData);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Successfully created list "${list.name}" (ID: ${list.id})`
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.create_list', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to create list: ${errorMessage}`
-                }]
-        };
-    }
-}
-/**
- * Handles the create_folder tool request
- * Creates a new folder in the specified space
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID to create folder in
- * @param args - Folder creation arguments
- * @returns Promise resolving to MCP-formatted response
- */
-export async function handleCreateFolder(clickup, teamId, args) {
-    try {
-        const spaceId = await resolveSpaceId(clickup, teamId, args.spaceId, args.spaceName);
-        const { spaceId: _, spaceName: __, ...folderData } = args;
-        const folder = await clickup.createFolder(spaceId, folderData);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Successfully created folder "${folder.name}" (ID: ${folder.id})`
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.create_folder', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to create folder: ${errorMessage}`
-                }]
-        };
-    }
-}
-/**
- * Handles the create_list_in_folder tool request
- * Creates a new list within a specified folder
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID to create list in
- * @param args - List creation arguments
- * @returns Promise resolving to MCP-formatted response
- */
-export async function handleCreateListInFolder(clickup, teamId, args) {
-    try {
-        let folderId = args.folderId;
-        if (!folderId) {
-            const spaceId = await resolveSpaceId(clickup, teamId, args.spaceId, args.spaceName);
-            folderId = await resolveFolderId(clickup, teamId, undefined, args.folderName);
-        }
-        const { folderId: _, folderName: __, spaceId: ___, spaceName: ____, ...listData } = args;
-        const list = await clickup.createListInFolder(folderId, listData);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Successfully created list "${list.name}" (ID: ${list.id}) in folder`
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.create_list_in_folder', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to create list in folder: ${errorMessage}`
-                }]
-        };
-    }
-}
-/**
- * Handles the move_task tool request
- * Moves a task to a different list
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID
- * @param args - Task move arguments
- * @returns Promise resolving to MCP-formatted response
- */
-export async function handleMoveTask(clickup, teamId, args) {
-    try {
-        const listId = await resolveListId(clickup, teamId, args.listId, args.listName);
-        await clickup.moveTask(args.taskId, listId);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Successfully moved task ${args.taskId} to list ${listId}`
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.move_task', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to move task: ${errorMessage}`
-                }]
-        };
-    }
-}
-/**
- * Handles the duplicate_task tool request
- * Creates a copy of a task in a specified list
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID
- * @param args - Task duplication arguments
- * @returns Promise resolving to MCP-formatted response
- */
-export async function handleDuplicateTask(clickup, teamId, args) {
-    try {
-        const listId = await resolveListId(clickup, teamId, args.listId, args.listName);
-        const task = await clickup.duplicateTask(args.taskId, listId);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Successfully duplicated task "${task.name}" (ID: ${task.id})`
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.duplicate_task', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to duplicate task: ${errorMessage}`
-                }]
-        };
-    }
-}
-/**
- * Handles the update_task tool request
- * Updates an existing task with new data
- * @param clickup - ClickUp service instance
- * @param teamId - Team ID
- * @param args - Task update arguments
- * @returns Promise resolving to MCP-formatted response
- */
-export async function handleUpdateTask(clickup, teamId, args) {
-    try {
-        const { taskId, ...updateData } = args;
-        const task = await clickup.updateTask(taskId, updateData);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `Successfully updated task "${task.name}" (ID: ${task.id})`
-                }]
-        };
-    }
-    catch (error) {
-        logError('tool.update_task', error);
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{
-                    type: 'error',
-                    text: `Failed to update task: ${errorMessage}`
-                }]
-        };
-    }
+    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...