@taazkareem/clickup-mcp-server 0.7.1 → 0.8.0

package/README.md

@@ -6,7 +6,7 @@
 
 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:** v0.7.1 now available with complete Time Tracking support and Document Management features.
+> 🚀 **Status Update:** v0.8.0 is now available with HTTP Streamable transport support, Legacy SSE Support, Member Management tools, and more.
 
 ## Setup
 
@@ -59,17 +59,86 @@ Additionally, you can use the `DISABLED_TOOLS` environment variable or `--env DI
 
 Please disable tools you don't need if you are having issues with the number of tools or any context limitations
 
+## Running with HTTP Transport Support
+
+The server supports both modern **HTTP Streamable** transport (MCP Inspector compatible) and legacy **SSE (Server-Sent Events)** transport for backwards compatibility.
+
+```json
+{
+  "mcpServers": {
+    "ClickUp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@taazkareem/clickup-mcp-server@latest"
+      ],
+      "env": {
+        "CLICKUP_API_KEY": "your-api-key",
+        "CLICKUP_TEAM_ID": "your-team-id",
+        "ENABLE_SSE": "true",
+        "PORT": "3231"
+      }
+    }
+  }
+}
+```
+
+**Endpoints:**
+- **Primary**: `http://127.0.0.1:3231/mcp` (Streamable HTTP)
+- **Legacy**: `http://127.0.0.1:3231/sse` (SSE for backwards compatibility)
+
+### Command Line Usage
+
+```bash
+npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=3231
+```
+
+Available configuration options:
+
+| Option | Description | Default |
+| ------ | ----------- | ------- |
+| `ENABLE_SSE` | Enable the HTTP/SSE transport | `false` |
+| `PORT` | Port for the HTTP server | `3231` |
+| `ENABLE_STDIO` | Enable the STDIO transport | `true` |
+
+#### n8n Integration
+
+To integrate with n8n:
+
+1. Start the clickup-mcp-server with SSE enabled
+2. In n8n, add a new "MCP AI Tool" node
+3. Configure the node with:
+   - Transport: SSE
+   - Server URL: `http://localhost:3231` (or your server address)
+   - Tools: Select the ClickUp tools you want to use
+
+#### Example Client
+
+An example SSE client is provided in the `examples` directory. To run it:
+
+```bash
+# Start the server with SSE enabled
+ENABLE_SSE=true PORT=3231 npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id
+
+# In another terminal, run the example client
+cd examples
+npm install
+npm run sse-client
+```
+
 ## Features
 
-| 📝 Task Management                                                                                                                                                                                                                                                    | 🏷️ Tag Management                                                                                                                                                                                                                                                         |
-| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| • Create, update, and delete tasks `<br>`• Move and duplicate tasks anywhere `<br>`• Support for single and bulk operations `<br>`• Set start/due dates with natural language `<br>`• Create and manage subtasks `<br>`• Add comments and attachments | • Create, update, and delete space tags `<br>`• Add and remove tags from tasks `<br>`• Use natural language color commands `<br>`• Automatic contrasting foreground colors `<br>`• View all space tags `<br>`• Tag-based task organization across workspace |
-| ⏱️**Time Tracking**                                                                                                                                                                                                                                           | 🌳**Workspace Organization**                                                                                                                                                                                                                                          |
-| • View time entries for tasks `<br>`• Start/stop time tracking on tasks `<br>`• Add manual time entries `<br>`• Delete time entries `<br>`• View currently running timer `<br>`• Track billable and non-billable time                                 | • Navigate spaces, folders, and lists `<br>`• Create and manage folders `<br>`• Organize lists within spaces `<br>`• Create lists in folders `<br>`• View workspace hierarchy `<br>`• Efficient path navigation                                             |
-| ⚡**Integration Features**                                                                                                                                                                                                                                      | **Document Listing, Creation and Updating!**                                                                                                                                                                                                                          |
-| • Global name or ID-based lookups `<br>`• Case-insensitive matching `<br>`• Markdown formatting support `<br>`• Built-in rate limiting `<br>`• Error handling and validation `<br>`• Comprehensive API coverage                                       | • Document Listing through all workspace `<br>` • Document Page listing `<br>` • Document Page Details `<br>` • Document Creation `<br>` • Document page update, modification (append and prepend) `<br>`                                                    |
+| 📝 Task Management                                                                                                                                                                                                                                                   | 🏷️ Tag Management                                                                                                                                                                                                                                                        |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| • Create, update, and delete tasks<br>• Move and duplicate tasks anywhere<br>• Support for single and bulk operations<br>• Set start/due dates with natural language<br>• Create and manage subtasks<br>• Add comments and attachments | • Create, update, and delete space tags<br>• Add and remove tags from tasks<br>• Use natural language color commands<br>• Automatic contrasting foreground colors<br>• View all space tags<br>• Tag-based task organization across workspace |
+| ⏱️ **Time Tracking**                                                                                                                                                                                                                                          | 🌳 **Workspace Organization**                                                                                                                                                                                                                                         |
+| • View time entries for tasks<br>• Start/stop time tracking on tasks<br>• Add manual time entries<br>• Delete time entries<br>• View currently running timer<br>• Track billable and non-billable time                                 | • Navigate spaces, folders, and lists<br>• Create and manage folders<br>• Organize lists within spaces<br>• Create lists in folders<br>• View workspace hierarchy<br>• Efficient path navigation                                             |
+| 📄 **Document Management**                                                                                                                                                                                                                                      | 👥 **Member Management**                                                                                                                                                                                                                                             |
+| • Document Listing through all workspace<br>• Document Page listing<br>• Document Page Details<br>• Document Creation<br>• Document page update (append & prepend)                                                                       | • Find workspace members by name or email<br>• Resolve assignees for tasks<br>• View member details and permissions<br>• Assign tasks to users during creation and updates<br>• Support for user IDs, emails, or usernames<br>• Team-wide user management                            |
+| ⚡ **Integration Features**                                                                                                                                                                                                                                      | 🏗️ **Architecture & Performance**                                                                                                                                                                                                                                        |
+| • Global name or ID-based lookups<br>• Case-insensitive matching<br>• Markdown formatting support<br>• Built-in rate limiting<br>• Error handling and validation<br>• Comprehensive API coverage                                             | • **70% codebase reduction** for improved performance<br>• **Unified architecture** across all transport types<br>• **Zero code duplication**<br>• **HTTP Streamable transport** (MCP Inspector compatible)<br>• **Legacy SSE support** for backwards compatibility |
 
-## Available Tools
+## Available Tools (36 Total)
 
 | Tool                                                               | Description                     | Required Parameters                                                                                                          |
 | ------------------------------------------------------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
@@ -110,6 +179,9 @@ Please disable tools you don't need if you are having issues with the number of
 | [add_time_entry](docs/api-reference.md#time-tracking)                 | Add manual time entry to a task | `taskId`/`taskName`, `start`, `duration`                                                                             |
 | [delete_time_entry](docs/api-reference.md#time-tracking)              | Delete a time entry             | `timeEntryId`                                                                                                              |
 | [get_current_time_entry](docs/api-reference.md#time-tracking)         | Get currently running timer     | None                                                                                                                         |
+| [get_workspace_members](docs/api-reference.md#member-management)      | Get all workspace members       | None                                                                                                                         |
+| [find_member_by_name](docs/api-reference.md#member-management)        | Find member by name or email    | `nameOrEmail`                                                                                                               |
+| [resolve_assignees](docs/api-reference.md#member-management)          | Resolve member names to IDs     | `assignees[]`                                                                                                              |
 | [create_document](docs/api-reference.md#document-management)          | Create a document               | `workspaceId`, `name`, `parentId`/`parentType`, `visibility`, `create_pages`                                     |
 | [get_document](docs/api-reference.md#document-management)             | Get a document                  | `workspaceId`/`documentId`                                                                                               |
 | [list_documents](docs/api-reference.md#document-management)           | List documents                  | `workspaceId`, `documentId`/`creator`/`deleted`/`archived`/`parent_id`/`parent_type`/`limit`/`next_cursor` |
@@ -120,6 +192,29 @@ Please disable tools you don't need if you are having issues with the number of
 
 See [full documentation](docs/api-reference.md) for optional parameters and advanced usage.
 
+## Member Management Tools
+
+When creating or updating tasks, you can assign users using the `assignees` parameter. The parameter accepts an array of user IDs, emails, or usernames:
+
+**Creating tasks with assignees:**
+```json
+{
+  "name": "New Task",
+  "description": "This is a new task.",
+  "assignees": ["jdoe@example.com", "Jane Smith"]  // Emails, usernames, or user IDs
+}
+```
+
+**Updating task assignees:**
+```json
+{
+  "taskId": "abc123",
+  "assignees": ["newuser@example.com"]  // Replace existing assignees
+}
+```
+
+The member management tools help resolve user references when needed.
+
 ## Prompts
 
 Not yet implemented and not supported by all client apps. Request a feature for a Prompt implementation that would be most beneficial for your workflow (without it being too specific). Examples:
@@ -175,4 +270,4 @@ This software makes use of third-party APIs and may reference trademarks
 or brands owned by third parties. The use of such APIs or references does not imply
 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.
+work and is not officially associated with or sponsored by any third-party company mentioned.

package/build/config.js

@@ -11,6 +11,11 @@
  * The document support is optional and can be passed via command line arguments.
  * The default value is 'false' (string), which means document support will be disabled if
  * no parameter is passed. Pass it as 'true' (string) to enable it.
+ *
+ * Server transport options:
+ * - ENABLE_SSE: Enable Server-Sent Events transport (default: false)
+ * - SSE_PORT: Port for SSE server (default: 3000)
+ * - ENABLE_STDIO: Enable STDIO transport (default: true)
  */
 // Parse any command line environment arguments
 const args = process.argv.slice(2);
@@ -34,6 +39,14 @@ for (let i = 0; i < args.length; i++) {
             envArgs.disabledTools = value;
         if (key === 'DISABLED_COMMANDS')
             envArgs.disabledTools = value; // Backward compatibility
+        if (key === 'ENABLE_SSE')
+            envArgs.enableSSE = value;
+        if (key === 'SSE_PORT')
+            envArgs.ssePort = value;
+        if (key === 'ENABLE_STDIO')
+            envArgs.enableStdio = value;
+        if (key === 'PORT')
+            envArgs.port = value;
         i++;
     }
 }
@@ -61,6 +74,19 @@ export const parseLogLevel = (levelStr) => {
             return LogLevel.ERROR;
     }
 };
+// Parse boolean string
+const parseBoolean = (value, defaultValue) => {
+    if (value === undefined)
+        return defaultValue;
+    return value.toLowerCase() === 'true';
+};
+// Parse integer string
+const parseInteger = (value, defaultValue) => {
+    if (value === undefined)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+};
 // Load configuration from command line args or environment variables
 const configuration = {
     clickupApiKey: envArgs.clickupApiKey || process.env.CLICKUP_API_KEY || '',
@@ -69,6 +95,10 @@ const configuration = {
     documentSupport: envArgs.documentSupport || process.env.DOCUMENT_SUPPORT || process.env.DOCUMENT_MODULE || process.env.DOCUMENT_MODEL || 'false',
     logLevel: parseLogLevel(envArgs.logLevel || process.env.LOG_LEVEL),
     disabledTools: ((envArgs.disabledTools || process.env.DISABLED_TOOLS || process.env.DISABLED_COMMANDS)?.split(',').map(cmd => cmd.trim()).filter(cmd => cmd !== '') || []),
+    enableSSE: parseBoolean(envArgs.enableSSE || process.env.ENABLE_SSE, false),
+    ssePort: parseInteger(envArgs.ssePort || process.env.SSE_PORT, 3000),
+    enableStdio: parseBoolean(envArgs.enableStdio || process.env.ENABLE_STDIO, true),
+    port: envArgs.port || process.env.PORT || '3231',
 };
 // Don't log to console as it interferes with JSON-RPC communication
 // Validate only the required variables are present

package/build/index.js

@@ -18,14 +18,17 @@
  * - Name-based entity resolution
  * - Markdown formatting
  * - Built-in rate limiting
+ * - Multiple transport options (STDIO, SSE, HTTP Streamable)
  *
  * For full documentation and usage examples, please refer to the README.md file.
  */
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { configureServer, server } from "./server.js";
-import { info, error } from "./logger.js";
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { configureServer, server } from './server.js';
+import { info, error } from './logger.js';
+import config from './config.js';
 import { dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { startSSEServer } from './sse_server.js';
 // Get directory name for module paths
 const __dirname = dirname(fileURLToPath(import.meta.url));
 // Handle uncaught exceptions
@@ -38,30 +41,43 @@ process.on('unhandledRejection', (reason, promise) => {
     error("Unhandled Rejection", { reason });
     process.exit(1);
 });
+async function startStdioServer() {
+    info('Starting ClickUp MCP Server...');
+    // Log essential information about the environment
+    info('Server environment', {
+        pid: process.pid,
+        node: process.version,
+        os: process.platform,
+        arch: process.arch,
+    });
+    // Configure the server with all handlers
+    info('Configuring server request handlers');
+    await configureServer();
+    // Connect using stdio transport
+    info('Connecting to MCP stdio transport');
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    info('Server startup complete - ready to handle requests');
+}
 /**
  * Application entry point that configures and starts the MCP server.
  */
 async function main() {
     try {
-        info("Starting ClickUp MCP Server...");
-        // Log essential information about the environment
-        info("Server environment", {
-            pid: process.pid,
-            node: process.version,
-            os: process.platform,
-            arch: process.arch
-        });
-        // Configure the server with all handlers
-        info("Configuring server request handlers");
-        await configureServer();
-        // Connect using stdio transport
-        info("Connecting to MCP stdio transport");
-        const transport = new StdioServerTransport();
-        await server.connect(transport);
-        info("Server startup complete - ready to handle requests");
+        if (config.enableSSE) {
+            // Start the new SSE server with HTTP Streamable support
+            startSSEServer();
+        }
+        else {
+            // Start the traditional STDIO server
+            await startStdioServer();
+        }
     }
     catch (err) {
-        error("Error during server startup", { message: err.message, stack: err.stack });
+        error('Error during server startup', {
+            message: err.message,
+            stack: err.stack,
+        });
         process.exit(1);
     }
 }

package/build/schemas/member.js

@@ -0,0 +1,13 @@
+// src/schemas/member.ts
+import { z } from 'zod';
+export const MemberSchema = z.object({
+    id: z.number(),
+    username: z.string().optional(),
+    email: z.string().optional(),
+    full_name: z.string().optional(),
+    profile_picture: z.string().optional(),
+    role: z.number(),
+    role_name: z.string().optional(),
+    initials: z.string().optional(),
+    last_active: z.string().optional(),
+});

package/build/server.js

@@ -13,6 +13,7 @@ import { createListTool, handleCreateList, createListInFolderTool, handleCreateL
 import { createFolderTool, handleCreateFolder, getFolderTool, handleGetFolder, updateFolderTool, handleUpdateFolder, deleteFolderTool, handleDeleteFolder } from "./tools/folder.js";
 import { getSpaceTagsTool, handleGetSpaceTags, addTagToTaskTool, handleAddTagToTask, removeTagFromTaskTool, handleRemoveTagFromTask } from "./tools/tag.js";
 import { createDocumentTool, handleCreateDocument, getDocumentTool, handleGetDocument, listDocumentsTool, handleListDocuments, listDocumentPagesTool, handleListDocumentPages, getDocumentPagesTool, handleGetDocumentPages, createDocumentPageTool, handleCreateDocumentPage, updateDocumentPageTool, handleUpdateDocumentPage } from "./tools/documents.js";
+import { getWorkspaceMembersTool, handleGetWorkspaceMembers, findMemberByNameTool, handleFindMemberByName, resolveAssigneesTool, handleResolveAssignees } from "./tools/member.js";
 import { Logger } from "./logger.js";
 import { clickUpServices } from "./services/shared.js";
 // Create a logger instance for server
@@ -21,7 +22,7 @@ const logger = new Logger('Server');
 const { workspace } = clickUpServices;
 export const server = new Server({
     name: "clickup-mcp-server",
-    version: "0.7.1",
+    version: "0.8.0",
 }, {
     capabilities: {
         tools: {},
@@ -88,6 +89,9 @@ export function configureServer() {
                 getSpaceTagsTool,
                 addTagToTaskTool,
                 removeTagFromTaskTool,
+                getWorkspaceMembersTool,
+                findMemberByNameTool,
+                resolveAssigneesTool,
                 ...documentModule()
             ].filter(tool => !config.disabledTools.includes(tool.name))
         };
@@ -99,8 +103,8 @@ export function configureServer() {
     });
     // Register CallTool handler with proper logging
     logger.info("Registering tool handlers", {
-        toolCount: 40,
-        categories: ["workspace", "task", "time-tracking", "list", "folder", "tag", "document"]
+        toolCount: 36,
+        categories: ["workspace", "task", "time-tracking", "list", "folder", "tag", "member", "document"]
     });
     server.setRequestHandler(CallToolRequestSchema, async (req) => {
         const { name, arguments: params } = req.params;
@@ -199,6 +203,12 @@ export function configureServer() {
                     return handleCreateDocumentPage(params);
                 case "update_document_page":
                     return handleUpdateDocumentPage(params);
+                case "get_workspace_members":
+                    return handleGetWorkspaceMembers();
+                case "find_member_by_name":
+                    return handleFindMemberByName(params);
+                case "resolve_assignees":
+                    return handleResolveAssignees(params);
                 default:
                     logger.error(`Unknown tool requested: ${name}`);
                     const error = new Error(`Unknown tool: ${name}`);

package/build/services/clickup/workspace.js

@@ -366,4 +366,32 @@ export class WorkspaceService extends BaseClickUpService {
             throw this.handleError(error, `Failed to get lists in folder ${folderId}`);
         }
     }
+    /**
+     * Get all members in a workspace
+     * @returns Array of workspace members
+     */
+    async getWorkspaceMembers() {
+        try {
+            // Use the existing team/workspace endpoint which typically returns member information
+            const teamId = this.teamId;
+            const response = await this.client.get(`/team/${teamId}`);
+            if (!response || !response.data || !response.data.team) {
+                throw new Error('Invalid response from ClickUp API');
+            }
+            // Extract and normalize member data
+            const members = response.data.team.members || [];
+            return members.map((member) => ({
+                id: member.user?.id,
+                name: member.user?.username || member.user?.email,
+                username: member.user?.username,
+                email: member.user?.email,
+                role: member.role,
+                profilePicture: member.user?.profilePicture
+            }));
+        }
+        catch (error) {
+            console.error('Error getting workspace members:', error);
+            throw error;
+        }
+    }
 }

package/build/sse_server.js

@@ -0,0 +1,113 @@
+/**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
+ * SSE and HTTP Streamable Transport Server
+ *
+ * This module provides HTTP Streamable and legacy SSE transport support
+ * for the ClickUp MCP Server. It reuses the unified server configuration
+ * from server.ts to avoid code duplication.
+ */
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import express from 'express';
+import { server, configureServer } from './server.js';
+import configuration from './config.js';
+const app = express();
+app.use(express.json());
+export function startSSEServer() {
+    // Configure the unified server first
+    configureServer();
+    const transports = {
+        streamable: {},
+        sse: {},
+    };
+    // Streamable HTTP endpoint - handles POST requests for client-to-server communication
+    app.post('/mcp', async (req, res) => {
+        try {
+            const sessionId = req.headers['mcp-session-id'];
+            let transport;
+            if (sessionId && transports.streamable[sessionId]) {
+                transport = transports.streamable[sessionId];
+            }
+            else if (!sessionId && isInitializeRequest(req.body)) {
+                transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => `session_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`,
+                    onsessioninitialized: (sessionId) => {
+                        transports.streamable[sessionId] = transport;
+                    }
+                });
+                transport.onclose = () => {
+                    if (transport.sessionId) {
+                        delete transports.streamable[transport.sessionId];
+                    }
+                };
+                await server.connect(transport);
+            }
+            else {
+                res.status(400).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32000,
+                        message: 'Bad Request: No valid session ID provided',
+                    },
+                    id: null,
+                });
+                return;
+            }
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            console.error('Error handling MCP request:', error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32603,
+                        message: 'Internal server error',
+                    },
+                    id: null,
+                });
+            }
+        }
+    });
+    const handleSessionRequest = async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (!sessionId || !transports.streamable[sessionId]) {
+            res.status(400).send('Invalid or missing session ID');
+            return;
+        }
+        const transport = transports.streamable[sessionId];
+        await transport.handleRequest(req, res);
+    };
+    app.get('/mcp', handleSessionRequest);
+    app.delete('/mcp', handleSessionRequest);
+    // Legacy SSE endpoints (for backwards compatibility)
+    app.get('/sse', async (req, res) => {
+        const transport = new SSEServerTransport('/messages', res);
+        transports.sse[transport.sessionId] = transport;
+        console.log(`New SSE connection established with sessionId: ${transport.sessionId}`);
+        res.on('close', () => {
+            delete transports.sse[transport.sessionId];
+        });
+        await server.connect(transport);
+    });
+    app.post('/messages', async (req, res) => {
+        const sessionId = req.query.sessionId;
+        const transport = transports.sse[sessionId];
+        if (transport) {
+            await transport.handlePostMessage(req, res, req.body);
+        }
+        else {
+            res.status(400).send('No transport found for sessionId');
+        }
+    });
+    const PORT = Number(configuration.port ?? '3231');
+    // Bind to localhost only for security
+    app.listen(PORT, () => {
+        console.log(`Server started on http://127.0.0.1:${PORT}`);
+        console.log(`Streamable HTTP endpoint: http://127.0.0.1:${PORT}/mcp`);
+        console.log(`Legacy SSE endpoint: http://127.0.0.1:${PORT}/sse`);
+    });
+}

package/build/tools/index.js

@@ -13,3 +13,4 @@ export * from './task/index.js';
 export * from './list.js';
 export * from './folder.js';
 export * from './tag.js';
+export * from './member.js';

package/build/tools/member.js

@@ -0,0 +1,108 @@
+import { workspaceService } from '../services/shared.js';
+import { sponsorService } from '../utils/sponsor-service.js';
+/**
+ * Tool definition for getting all members in a ClickUp workspace
+ */
+export const getWorkspaceMembersTool = {
+    name: 'get_workspace_members',
+    description: 'Returns all members (users) in the ClickUp workspace/team. Useful for resolving assignees by name or email.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    }
+};
+/**
+ * Tool definition for finding a member by name or email
+ */
+export const findMemberByNameTool = {
+    name: 'find_member_by_name',
+    description: 'Finds a member in the ClickUp workspace by name or email. Returns the member object if found, or null if not found.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            nameOrEmail: {
+                type: 'string',
+                description: 'The name or email of the member to find.'
+            }
+        },
+        required: ['nameOrEmail']
+    }
+};
+/**
+ * Tool definition for resolving an array of assignee names/emails to ClickUp user IDs
+ */
+export const resolveAssigneesTool = {
+    name: 'resolve_assignees',
+    description: 'Resolves an array of assignee names or emails to ClickUp user IDs. Returns an array of user IDs, or errors for any that cannot be resolved.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            assignees: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of assignee names or emails to resolve.'
+            }
+        },
+        required: ['assignees']
+    }
+};
+/// src/tools/member.ts
+/**
+ * Handler for get_workspace_members
+ */
+export async function handleGetWorkspaceMembers() {
+    try {
+        const members = await workspaceService.getWorkspaceMembers();
+        return sponsorService.createResponse({ members }, true);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return sponsorService.createErrorResponse(`Failed to get workspace members: ${errorMessage}`);
+    }
+}
+/**
+ * Handler for find_member_by_name
+ */
+export async function handleFindMemberByName(parameters) {
+    const { nameOrEmail } = parameters;
+    if (!nameOrEmail) {
+        throw new Error('nameOrEmail is required');
+    }
+    try {
+        const members = await workspaceService.getWorkspaceMembers();
+        const found = members.find((m) => m.email?.toLowerCase() === nameOrEmail.toLowerCase() ||
+            m.username?.toLowerCase() === nameOrEmail.toLowerCase() ||
+            m.name?.toLowerCase() === nameOrEmail.toLowerCase());
+        return sponsorService.createResponse({ member: found || null }, true);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return sponsorService.createErrorResponse(`Failed to find member: ${errorMessage}`);
+    }
+}
+/**
+ * Handler for resolve_assignees
+ */
+export async function handleResolveAssignees(parameters) {
+    const { assignees } = parameters;
+    if (!Array.isArray(assignees)) {
+        throw new Error('assignees must be an array');
+    }
+    try {
+        const members = await workspaceService.getWorkspaceMembers();
+        const resolved = assignees.map((input) => {
+            const found = members.find((m) => m.email?.toLowerCase() === input.toLowerCase() ||
+                m.username?.toLowerCase() === input.toLowerCase() ||
+                m.name?.toLowerCase() === input.toLowerCase());
+            return found ? found.id : null;
+        });
+        // Return a plain object, not wrapped in sponsorService.createResponse
+        return { userIds: resolved };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Return a plain error object
+        return { error: `Failed to resolve assignees: ${errorMessage}` };
+    }
+}

package/build/tools/task/bulk-operations.js

@@ -73,7 +73,7 @@ const taskIdentifierSchema = {
  */
 export const createBulkTasksTool = {
     name: "create_bulk_tasks",
-    description: `Creates multiple tasks in one list. Use listId (preferred) or listName + array of tasks (each needs name). Configure batch size/concurrency via options. Tasks can have custom fields as {id, value} array.`,
+    description: `Creates multiple tasks in one list. Use listId (preferred) or listName + array of tasks (each needs name). Configure batch size/concurrency via options. Tasks can have custom fields as {id, value} array and assignees as array of user IDs, emails, or usernames.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -130,6 +130,16 @@ export const createBulkTasksTool = {
                                 required: ["id", "value"]
                             },
                             description: "Optional array of custom field values to set on the task."
+                        },
+                        assignees: {
+                            type: "array",
+                            items: {
+                                oneOf: [
+                                    { type: "number" },
+                                    { type: "string" }
+                                ]
+                            },
+                            description: "Optional array of assignee user IDs (numbers), emails, or usernames to assign to the task."
                         }
                     },
                     required: ["name"]
@@ -153,7 +163,7 @@ export const createBulkTasksTool = {
  */
 export const updateBulkTasksTool = {
     name: "update_bulk_tasks",
-    description: `Updates multiple tasks efficiently. For each task: use taskId (preferred) or taskName + listName. At least one update field per task. Configure batch size/concurrency via options. WARNING: taskName without listName will fail.`,
+    description: `Updates multiple tasks efficiently. For each task: use taskId (preferred) or taskName + listName. At least one update field per task. Supports assignees as array of user IDs, emails, or usernames. Configure batch size/concurrency via options. WARNING: taskName without listName will fail.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -221,6 +231,16 @@ export const updateBulkTasksTool = {
                                 required: ["id", "value"]
                             },
                             description: "Optional array of custom field values to set on the task."
+                        },
+                        assignees: {
+                            type: "array",
+                            items: {
+                                oneOf: [
+                                    { type: "number" },
+                                    { type: "string" }
+                                ]
+                            },
+                            description: "Optional array of assignee user IDs (numbers), emails, or usernames to assign to the task."
                         }
                     }
                 }

package/build/tools/task/handlers.js

@@ -51,6 +51,34 @@ function getCachedTaskContext(taskName) {
 //=============================================================================
 // SHARED UTILITY FUNCTIONS
 //=============================================================================
+/**
+ * Parse time estimate string into minutes
+ * Supports formats like "2h 30m", "150m", "2.5h"
+ */
+function parseTimeEstimate(timeEstimate) {
+    // If it's already a number, return it directly
+    if (typeof timeEstimate === 'number') {
+        return timeEstimate;
+    }
+    if (!timeEstimate || typeof timeEstimate !== 'string')
+        return 0;
+    // If it's just a number as string, parse it
+    if (/^\d+$/.test(timeEstimate)) {
+        return parseInt(timeEstimate, 10);
+    }
+    let totalMinutes = 0;
+    // Extract hours
+    const hoursMatch = timeEstimate.match(/(\d+\.?\d*)h/);
+    if (hoursMatch) {
+        totalMinutes += parseFloat(hoursMatch[1]) * 60;
+    }
+    // Extract minutes
+    const minutesMatch = timeEstimate.match(/(\d+)m/);
+    if (minutesMatch) {
+        totalMinutes += parseInt(minutesMatch[1], 10);
+    }
+    return Math.round(totalMinutes); // Return minutes
+}
 /**
  * Build task update data from parameters
  */
@@ -75,6 +103,15 @@ function buildUpdateData(params) {
         updateData.start_date = parseDueDate(params.startDate);
         updateData.start_date_time = true;
     }
+    // Handle time estimate if provided - convert from string to minutes
+    if (params.time_estimate !== undefined) {
+        // Log the time estimate for debugging
+        console.log(`Original time_estimate: ${params.time_estimate}, typeof: ${typeof params.time_estimate}`);
+        // Parse and convert to number in minutes
+        const minutes = parseTimeEstimate(params.time_estimate);
+        console.log(`Converted time_estimate: ${minutes}`);
+        updateData.time_estimate = minutes;
+    }
     // Handle custom fields if provided
     if (params.custom_fields !== undefined) {
         updateData.custom_fields = params.custom_fields;
@@ -334,7 +371,7 @@ async function mapTaskIds(tasks) {
  * Handler for creating a task
  */
 export async function createTaskHandler(params) {
-    const { name, description, markdown_description, status, dueDate, startDate, parent, tags, custom_fields, check_required_custom_fields } = params;
+    const { name, description, markdown_description, status, dueDate, startDate, parent, tags, custom_fields, check_required_custom_fields, assignees } = params;
     if (!name)
         throw new Error("Task name is required");
     // Use our helper function to validate and convert priority
@@ -349,7 +386,8 @@ export async function createTaskHandler(params) {
         parent,
         tags,
         custom_fields,
-        check_required_custom_fields
+        check_required_custom_fields,
+        assignees
     };
     // Add due date if specified
     if (dueDate) {
@@ -568,7 +606,8 @@ export async function createBulkTasksHandler(params) {
             status: task.status,
             priority: toTaskPriority(task.priority),
             tags: task.tags,
-            custom_fields: task.custom_fields
+            custom_fields: task.custom_fields,
+            assignees: task.assignees
         };
         // Add due date if specified
         if (task.dueDate) {

package/build/tools/task/main.js

@@ -12,6 +12,8 @@ import { sponsorService } from '../../utils/sponsor-service.js';
 import { createTaskTool, getTaskTool, getTasksTool, updateTaskTool, moveTaskTool, duplicateTaskTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool } from './single-operations.js';
 import { createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool } from './bulk-operations.js';
 import { getWorkspaceTasksTool } from './workspace-operations.js';
+// Add this to your import statements at the top of the file
+import { getWorkspaceMembersTool, findMemberByNameTool, resolveAssigneesTool, handleGetWorkspaceMembers, handleFindMemberByName, handleResolveAssignees } from '../member.js'; // Adjust the path as needed - it should point to where member.ts is located
 // Import handlers
 import { createTaskHandler, getTaskHandler, getTasksHandler, updateTaskHandler, moveTaskHandler, duplicateTaskHandler, deleteTaskHandler, getTaskCommentsHandler, createTaskCommentHandler, createBulkTasksHandler, updateBulkTasksHandler, moveBulkTasksHandler, deleteBulkTasksHandler, getWorkspaceTasksHandler, formatTaskData } from './index.js';
 // Import shared services
@@ -215,5 +217,17 @@ export const tools = [
                 errors: result.failed.map(f => f.error)
             };
         }
+    },
+    {
+        definition: getWorkspaceMembersTool,
+        handler: handleGetWorkspaceMembers
+    },
+    {
+        definition: findMemberByNameTool,
+        handler: handleFindMemberByName
+    },
+    {
+        definition: resolveAssigneesTool,
+        handler: handleResolveAssignees
     }
 ];

package/build/tools/task/single-operations.js

@@ -48,7 +48,7 @@ const handleOperationError = (operation, error) => {
  */
 export const createTaskTool = {
     name: "create_task",
-    description: `Creates a single task in a ClickUp list. Use listId (preferred) or listName. Required: name + list info. For multiple tasks use create_bulk_tasks. Can create subtasks via parent param. Supports custom fields as array of {id, value}.`,
+    description: `Creates a single task in a ClickUp list. Use listId (preferred) or listName. Required: name + list info. For multiple tasks use create_bulk_tasks. Can create subtasks via parent param. Supports custom fields as array of {id, value}. Supports assignees as array of user IDs, emails, or usernames.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -119,6 +119,16 @@ export const createTaskTool = {
             check_required_custom_fields: {
                 type: "boolean",
                 description: "Optional flag to check if all required custom fields are set before saving the task."
+            },
+            assignees: {
+                type: "array",
+                items: {
+                    oneOf: [
+                        { type: "number" },
+                        { type: "string" }
+                    ]
+                },
+                description: "Optional array of assignee user IDs (numbers), emails, or usernames to assign to the task."
             }
         }
     }
@@ -128,7 +138,7 @@ export const createTaskTool = {
  */
 export const updateTaskTool = {
     name: "update_task",
-    description: `Updates task properties. Use taskId (preferred) or taskName + optional listName. At least one update field required. Custom fields supported as array of {id, value}. WARNING: Using taskName without listName may match multiple tasks.`,
+    description: `Updates task properties. Use taskId (preferred) or taskName + optional listName. At least one update field required. Custom fields supported as array of {id, value}. Supports assignees as array of user IDs, emails, or usernames. WARNING: Using taskName without listName may match multiple tasks.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -174,6 +184,10 @@ export const updateTaskTool = {
                 type: "string",
                 description: "New start date. Supports both Unix timestamps (in milliseconds) and natural language expressions."
             },
+            time_estimate: {
+                type: "string",
+                description: "Time estimate for the task. For best compatibility with the ClickUp API, use a numeric value in minutes (e.g., '150' for 2h 30m)"
+            },
             custom_fields: {
                 type: "array",
                 items: {
@@ -190,6 +204,16 @@ export const updateTaskTool = {
                     required: ["id", "value"]
                 },
                 description: "Optional array of custom field values to set on the task. Each object must have an 'id' and 'value' property."
+            },
+            assignees: {
+                type: "array",
+                items: {
+                    oneOf: [
+                        { type: "number" },
+                        { type: "string" }
+                    ]
+                },
+                description: "Optional array of assignee user IDs (numbers), emails, or usernames to assign to the task."
             }
         }
     }

package/build/tools/task/utilities.js

@@ -112,14 +112,6 @@ export function validateListIdentification(listId, listName) {
  * Ensures at least one update field is provided
  */
 export function validateTaskUpdateData(updateData) {
-    // Check if there are any valid update fields present
-    const hasUpdates = Object.keys(updateData).some(key => {
-        return ['name', 'description', 'markdown_description', 'status', 'priority',
-            'dueDate', 'startDate', 'custom_fields'].includes(key);
-    });
-    if (!hasUpdates) {
-        throw new Error("At least one field to update must be provided");
-    }
     // Validate custom_fields if provided
     if (updateData.custom_fields) {
         if (!Array.isArray(updateData.custom_fields)) {
@@ -131,6 +123,10 @@ export function validateTaskUpdateData(updateData) {
             }
         }
     }
+    // Ensure there's at least one field to update
+    if (Object.keys(updateData).length === 0) {
+        throw new Error("At least one field to update must be provided");
+    }
 }
 /**
  * Validate bulk task array and task identification

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taazkareem/clickup-mcp-server",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",
@@ -55,11 +55,16 @@
   },
   "homepage": "https://github.com/taazkareem/clickup-mcp-server#readme",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.6.0",
+    "@modelcontextprotocol/sdk": "^1.11.3",
     "axios": "^1.6.7",
-    "dotenv": "^16.4.1"
+    "cors": "^2.8.5",
+    "dotenv": "^16.5.0",
+    "express": "^5.1.0",
+    "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.1",
     "@types/node": "^20.11.16",
     "typescript": "^5.3.3"
   },