@alanse/clickup-multi-mcp-server 1.0.0 → 1.0.2

package/README.md

@@ -1,9 +1,21 @@
-# ClickUp Multi-Workspace MCP Server
+<p align="center">
+  <img src="assets/images/clickup-social.png" alt="ClickUp Multi-Workspace MCP Server" width="100%">
+</p>
 
-[![GitHub Stars](https://img.shields.io/github/stars/da-okazaki/clickup-multi-mcp-server?style=flat&logo=github)](https://github.com/da-okazaki/clickup-multi-mcp-server/stargazers)
-[![NPM Version](https://img.shields.io/npm/v/@alanse/clickup-multi-mcp-server.svg?style=flat&logo=npm)](https://www.npmjs.com/package/@alanse/clickup-multi-mcp-server)
+<h1 align="center">ClickUp Multi-Workspace MCP Server</h1>
 
-A Model Context Protocol (MCP) server for integrating **multiple ClickUp workspaces** with AI applications. This server allows AI agents to interact with tasks, spaces, lists, and folders across different ClickUp workspaces through a standardized protocol.
+<p align="center">
+  <a href="https://github.com/da-okazaki/clickup-multi-mcp-server/stargazers">
+    <img src="https://img.shields.io/github/stars/da-okazaki/clickup-multi-mcp-server?style=flat&logo=github" alt="GitHub Stars">
+  </a>
+  <a href="https://www.npmjs.com/package/@alanse/clickup-multi-mcp-server">
+    <img src="https://img.shields.io/npm/v/@alanse/clickup-multi-mcp-server.svg?style=flat&logo=npm" alt="NPM Version">
+  </a>
+</p>
+
+<p align="center">
+  A Model Context Protocol (MCP) server for integrating <strong>multiple ClickUp workspaces</strong> with AI applications. This server allows AI agents to interact with tasks, spaces, lists, and folders across different ClickUp workspaces through a standardized protocol.
+</p>
 
 ## 🎯 Key Feature: Multi-Workspace Support
 
@@ -22,6 +34,27 @@ Based on the excellent [clickup-mcp-server](https://github.com/taazkareem/clicku
 
 ## Quick Start
 
+### Claude Code CLI Setup
+
+The easiest way to add this MCP server to Claude Code:
+
+**Single Workspace:**
+```bash
+claude mcp add clickup \
+  -e CLICKUP_API_KEY=your_api_key_here \
+  -e CLICKUP_TEAM_ID=your_team_id_here \
+  -- npx -y @alanse/clickup-multi-mcp-server@latest
+```
+
+**Multiple Workspaces:**
+```bash
+claude mcp add clickup \
+  -e CLICKUP_WORKSPACES='{"default":"work","workspaces":{"work":{"token":"pk_xxx_work","teamId":"123456"},"personal":{"token":"pk_xxx_personal","teamId":"789012"}}}' \
+  -- npx -y @alanse/clickup-multi-mcp-server@latest
+```
+
+### Manual Configuration
+
 ### Single Workspace (Backwards Compatible)
 
 The traditional single workspace setup still works exactly as before:
@@ -145,17 +178,77 @@ await getTasks({ workspace: "personal", list_id: "987654321" });
 await getWorkspaceHierarchy({ workspace: "work" });
 ```
 
+## Local Development Setup
+
+For local development or when running the server directly from source code:
+
+### 1. Clone and Install
+
+```bash
+git clone https://github.com/da-okazaki/clickup-multi-mcp-server.git
+cd clickup-multi-mcp-server
+npm install
+```
+
+### 2. Configure Environment Variables
+
+Copy `.env.example` to `.env` and configure your ClickUp credentials:
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` file:
+
+```bash
+# Multi-workspace configuration
+CLICKUP_WORKSPACES={"default":"alanse","workspaces":{"alanse":{"token":"pk_YOUR_TOKEN_1","teamId":"YOUR_TEAM_ID_1","description":"Alanse workspace"},"potz":{"token":"pk_YOUR_TOKEN_2","teamId":"YOUR_TEAM_ID_2","description":"Potz workspace"}}}
+
+# Or use single workspace (legacy)
+# CLICKUP_API_KEY=your_api_key_here
+# CLICKUP_TEAM_ID=your_team_id_here
+```
+
+**Note**: The `.env` file is automatically loaded when the server starts. Environment variables in `.env` are automatically picked up without needing to pass them via command line.
+
+### 3. Build and Run
+
+```bash
+# Build the project
+npm run build
+
+# Run locally
+node build/index.js
+```
+
+### 4. Configure Claude Code for Local Development
+
+If you want to use your local build with Claude Code, update `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "clickup": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/absolute/path/to/clickup-multi-mcp-server/build/index.js"]
+    }
+  }
+}
+```
+
+**Important**: When using local build with Claude Code:
+- Environment variables are loaded from `.env` file in the project root
+- No need to specify `env` in `~/.claude.json` (unless you want to override `.env` values)
+- Rebuild after making changes: `npm run build`
+
 ## 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 hosted on [Smithery](https://smithery.ai/server/@taazkareem/clickup-mcp-server). There, you can preview the available tools or copy the commands to run on your specific client app.
 
-## NPX Installation
 
-[![NPM Version](https://img.shields.io/npm/v/@taazkareem/clickup-mcp-server.svg?style=flat&logo=npm)](https://www.npmjs.com/package/@taazkareem/clickup-mcp-server)
-[![Dependency Status](https://img.shields.io/badge/dependencies-up%20to%20date-brightgreen)](https://github.com/TaazKareem/clickup-mcp-server/blob/main/package.json)
-[![NPM Downloads](https://img.shields.io/npm/dm/@taazkareem/clickup-mcp-server.svg?style=flat&logo=npm)](https://npmcharts.com/compare/@taazkareem/clickup-mcp-server?minimal=true)
 
 Add this entry to your client's MCP settings JSON file:
 
@@ -335,11 +428,12 @@ npm run sse-client
 | ⚡ **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 (36 Total)
+## Available Tools (42 Total)
 
 | Tool                                                               | Description                     | Required Parameters                                                                                                          |
 | ------------------------------------------------------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
 | [get_workspace_hierarchy](docs/user-guide.md#workspace-navigation) | Get workspace structure         | None                                                                                                                         |
+| [get_available_workspaces](docs/user-guide.md#workspace-navigation) | Get all available workspaces    | None                                                                                                                         |
 | [create_task](docs/user-guide.md#task-management)                  | Create a task                   | `name`, (`listId`/`listName`)                                                                                          |
 | [create_bulk_tasks](docs/user-guide.md#task-management)            | Create multiple tasks           | `tasks[]`                                                                                                                  |
 | [update_task](docs/user-guide.md#task-management)                  | Modify task                     | `taskId`/`taskName`                                                                                                      |
@@ -355,6 +449,11 @@ npm run sse-client
 | [move_task](docs/user-guide.md#task-management)                    | Move task                       | `taskId`/`taskName`, `listId`/`listName`                                                                             |
 | [move_bulk_tasks](docs/user-guide.md#task-management)              | Move multiple tasks             | `tasks[]` with IDs or names, target list                                                                                   |
 | [duplicate_task](docs/user-guide.md#task-management)               | Copy task                       | `taskId`/`taskName`, `listId`/`listName`                                                                             |
+| [merge_task](docs/user-guide.md#task-management)                   | Merge two tasks                 | `taskId`, `mergeFromId`                                                                                                  |
+| [get_task_time_in_status](docs/user-guide.md#task-management)      | Get time in status for a task   | `taskId`/`taskName`                                                                                                      |
+| [get_bulk_tasks_time_in_status](docs/user-guide.md#task-management)| Get bulk time in status         | `taskIds[]`                                                                                                              |
+| [add_task_to_list](docs/user-guide.md#list-management)             | Add task to additional list     | `listId`, `taskId`                                                                                                       |
+| [remove_task_from_list](docs/user-guide.md#list-management)        | Remove task from list           | `listId`, `taskId`                                                                                                       |
 | [create_list](docs/user-guide.md#list-management)                  | Create list in space            | `name`, `spaceId`/`spaceName`                                                                                          |
 | [create_folder](docs/user-guide.md#folder-management)              | Create folder                   | `name`, `spaceId`/`spaceName`                                                                                          |
 | [create_list_in_folder](docs/user-guide.md#list-management)        | Create list in folder           | `name`, `folderId`/`folderName`                                                                                        |
@@ -436,35 +535,9 @@ The server provides clear error messages for:
 The `LOG_LEVEL` environment variable can be specified to control the verbosity of server logs. Valid values are `trace`, `debug`, `info`, `warn`, and `error` (default).
 This can be also be specified on the command line as, e.g. `--env LOG_LEVEL=info`.
 
-## Support the Developer
-
-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!
-If you find this project useful, please consider supporting:
-
-[![Sponsor TaazKareem](https://img.shields.io/badge/Sponsor-TaazKareem-orange?logo=github)](https://github.com/sponsors/TaazKareem)
-
-<a href="https://buymeacoffee.com/taazkareem">
-  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" width="200" alt="Buy Me A Coffee">
-</a>
-
-## Acknowledgements
-
-Special thanks to [ClickUp](https://clickup.com) for their excellent API and services that make this integration possible.
-
-## Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
 
 ## License
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## Disclaimer
-
-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.

package/build/config.js

@@ -21,6 +21,9 @@
  * - SSE_PORT: Port for SSE server (default: 3000)
  * - ENABLE_STDIO: Enable STDIO transport (default: true)
  */
+// Load environment variables from .env file
+import dotenv from 'dotenv';
+dotenv.config();
 // Parse any command line environment arguments
 const args = process.argv.slice(2);
 const envArgs = {};
@@ -125,7 +128,6 @@ const configuration = {
     clickupApiKey: envArgs.clickupApiKey || process.env.CLICKUP_API_KEY || '',
     clickupTeamId: envArgs.clickupTeamId || process.env.CLICKUP_TEAM_ID || '',
     clickupWorkspaces: parseWorkspaces(),
-    enableSponsorMessage: process.env.ENABLE_SPONSOR_MESSAGE !== 'false',
     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 !== '') || []),

package/build/server.js

@@ -7,8 +7,8 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import config from "./config.js";
-import { workspaceHierarchyTool, handleGetWorkspaceHierarchy } from "./tools/workspace.js";
-import { createTaskTool, updateTaskTool, moveTaskTool, duplicateTaskTool, getTaskTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool, createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool, attachTaskFileTool, getWorkspaceTasksTool, getTaskTimeEntriesTool, startTimeTrackingTool, stopTimeTrackingTool, addTimeEntryTool, deleteTimeEntryTool, getCurrentTimeEntryTool, handleCreateTask, handleUpdateTask, handleMoveTask, handleDuplicateTask, handleDeleteTask, handleGetTaskComments, handleCreateTaskComment, handleCreateBulkTasks, handleUpdateBulkTasks, handleMoveBulkTasks, handleDeleteBulkTasks, handleGetTask, handleAttachTaskFile, handleGetWorkspaceTasks, handleGetTaskTimeEntries, handleStartTimeTracking, handleStopTimeTracking, handleAddTimeEntry, handleDeleteTimeEntry, handleGetCurrentTimeEntry } from "./tools/task/index.js";
+import { workspaceHierarchyTool, handleGetWorkspaceHierarchy, availableWorkspacesTool, handleGetAvailableWorkspaces } from "./tools/workspace.js";
+import { createTaskTool, updateTaskTool, moveTaskTool, duplicateTaskTool, getTaskTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool, createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool, attachTaskFileTool, getWorkspaceTasksTool, getTaskTimeEntriesTool, startTimeTrackingTool, stopTimeTrackingTool, addTimeEntryTool, deleteTimeEntryTool, getCurrentTimeEntryTool, mergeTaskTool, getTimeInStatusTool, getBulkTimeInStatusTool, addTaskToListTool, removeTaskFromListTool, handleCreateTask, handleUpdateTask, handleMoveTask, handleDuplicateTask, handleDeleteTask, handleGetTaskComments, handleCreateTaskComment, handleCreateBulkTasks, handleUpdateBulkTasks, handleMoveBulkTasks, handleDeleteBulkTasks, handleGetTask, handleAttachTaskFile, handleGetWorkspaceTasks, handleGetTaskTimeEntries, handleStartTimeTracking, handleStopTimeTracking, handleAddTimeEntry, handleDeleteTimeEntry, handleGetCurrentTimeEntry, mergeTaskHandler, getTimeInStatusHandler, getBulkTimeInStatusHandler, addTaskToListHandler, removeTaskFromListHandler } from "./tools/task/index.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 { getSpaceTagsTool, handleGetSpaceTags, addTagToTaskTool, handleAddTagToTask, removeTagFromTaskTool, handleRemoveTagFromTask } from "./tools/tag.js";
@@ -81,6 +81,7 @@ export function configureServer() {
         // Collect all tool definitions
         const allTools = [
             workspaceHierarchyTool,
+            availableWorkspacesTool,
             createTaskTool,
             getTaskTool,
             updateTaskTool,
@@ -101,6 +102,11 @@ export function configureServer() {
             addTimeEntryTool,
             deleteTimeEntryTool,
             getCurrentTimeEntryTool,
+            mergeTaskTool,
+            getTimeInStatusTool,
+            getBulkTimeInStatusTool,
+            addTaskToListTool,
+            removeTaskFromListTool,
             createListTool,
             createListInFolderTool,
             getListTool,
@@ -156,7 +162,9 @@ export function configureServer() {
             // Handle tool calls by routing to the appropriate handler
             switch (name) {
                 case "get_workspace_hierarchy":
-                    return handleGetWorkspaceHierarchy();
+                    return handleGetWorkspaceHierarchy(params);
+                case "get_available_workspaces":
+                    return handleGetAvailableWorkspaces();
                 case "create_task":
                     return handleCreateTask(params);
                 case "update_task":
@@ -221,6 +229,16 @@ export function configureServer() {
                     return handleDeleteTimeEntry(params);
                 case "get_current_time_entry":
                     return handleGetCurrentTimeEntry(params);
+                case "merge_task":
+                    return mergeTaskHandler(params);
+                case "get_task_time_in_status":
+                    return getTimeInStatusHandler(params);
+                case "get_bulk_tasks_time_in_status":
+                    return getBulkTimeInStatusHandler(params);
+                case "add_task_to_list":
+                    return addTaskToListHandler(params);
+                case "remove_task_from_list":
+                    return removeTaskFromListHandler(params);
                 case "create_document":
                     return handleCreateDocument(params);
                 case "get_document":

package/build/server.log

@@ -0,0 +1 @@
+Logging initialized to /Users/daichiokazaki/Documents/project/alanse/clickup-multi-mcp-server/build/server.log

package/build/services/clickup/task/task-core.js

@@ -601,4 +601,103 @@ export class TaskServiceCore extends BaseClickUpService {
         });
         this.logger.debug('Cached task name to ID mapping', { taskName, taskId, listId });
     }
+    /**
+     * Merge two tasks together
+     * @param taskId ID of the task to merge into (destination)
+     * @param data Merge configuration including merge_from_id
+     * @returns The merged task
+     */
+    async mergeTask(taskId, data) {
+        try {
+            this.logOperation('mergeTask', { taskId, ...data });
+            const path = `/task/${taskId}/merge`;
+            this.traceRequest('POST', path, data);
+            return await this.makeRequest(async () => {
+                const response = await this.client.post(path, data);
+                return response.data;
+            });
+        }
+        catch (error) {
+            throw this.handleError(error, `Failed to merge task ${taskId}`);
+        }
+    }
+    /**
+     * Get time in status for a task
+     * @param taskId ID of the task
+     * @returns Time in status data
+     */
+    async getTimeInStatus(taskId) {
+        try {
+            this.logOperation('getTimeInStatus', { taskId });
+            const path = `/task/${taskId}/time_in_status`;
+            this.traceRequest('GET', path);
+            return await this.makeRequest(async () => {
+                const response = await this.client.get(path);
+                return response.data;
+            });
+        }
+        catch (error) {
+            throw this.handleError(error, `Failed to get time in status for task ${taskId}`);
+        }
+    }
+    /**
+     * Get time in status for multiple tasks
+     * @param taskIds Array of task IDs
+     * @returns Bulk time in status data
+     */
+    async getBulkTimeInStatus(taskIds) {
+        try {
+            this.logOperation('getBulkTimeInStatus', { taskIds, count: taskIds.length });
+            // Convert array to query string: ?task_ids=id1&task_ids=id2
+            const queryParams = taskIds.map(id => `task_ids=${id}`).join('&');
+            const path = `/task/bulk_time_in_status/task_ids?${queryParams}`;
+            this.traceRequest('GET', path);
+            return await this.makeRequest(async () => {
+                const response = await this.client.get(path);
+                return response.data;
+            });
+        }
+        catch (error) {
+            throw this.handleError(error, `Failed to get bulk time in status`);
+        }
+    }
+    /**
+     * Add a task to an additional list (multiple list membership)
+     * @param listId ID of the list to add the task to
+     * @param taskId ID of the task to add
+     * @returns The updated task
+     */
+    async addTaskToList(listId, taskId) {
+        try {
+            this.logOperation('addTaskToList', { listId, taskId });
+            const path = `/list/${listId}/task/${taskId}`;
+            this.traceRequest('POST', path);
+            return await this.makeRequest(async () => {
+                const response = await this.client.post(path);
+                return response.data;
+            });
+        }
+        catch (error) {
+            throw this.handleError(error, `Failed to add task ${taskId} to list ${listId}`);
+        }
+    }
+    /**
+     * Remove a task from a list
+     * @param listId ID of the list to remove the task from
+     * @param taskId ID of the task to remove
+     * @returns Success indicator
+     */
+    async removeTaskFromList(listId, taskId) {
+        try {
+            this.logOperation('removeTaskFromList', { listId, taskId });
+            const path = `/list/${listId}/task/${taskId}`;
+            this.traceRequest('DELETE', path);
+            await this.makeRequest(async () => {
+                await this.client.delete(path);
+            });
+        }
+        catch (error) {
+            throw this.handleError(error, `Failed to remove task ${taskId} from list ${listId}`);
+        }
+    }
 }

package/build/services/shared.js

@@ -21,12 +21,15 @@ const workspaceServicesMap = new Map();
  */
 export function getClickUpServices(workspaceId) {
     const wsId = workspaceId || getDefaultWorkspace();
+    console.error('[DEBUG] getClickUpServices called with workspaceId:', workspaceId);
+    console.error('[DEBUG] Resolved workspace ID:', wsId);
     // Check if services already exist for this workspace
     let services = workspaceServicesMap.get(wsId);
     if (!services) {
         logger.info(`Creating ClickUp services for workspace: ${wsId}`);
         // Get workspace configuration
         const workspaceConfig = getWorkspaceConfig(wsId);
+        console.error('[DEBUG] Workspace config:', JSON.stringify(workspaceConfig));
         // Create the services instance
         services = createClickUpServices({
             apiKey: workspaceConfig.token,

package/build/tools/task/handlers.js

@@ -15,6 +15,7 @@ import { validateTaskIdentification, validateListIdentification, validateTaskUpd
 import { handleResolveAssignees } from '../member.js';
 import { isNameMatch } from '../../utils/resolver-utils.js';
 import { Logger } from '../../logger.js';
+import { sponsorService } from '../../utils/sponsor-service.js';
 // Use default workspace services for backwards compatibility
 const defaultServices = getClickUpServices();
 const { task: taskService, list: listService, workspace: workspaceService } = defaultServices;
@@ -917,3 +918,88 @@ export async function deleteTaskHandler(params) {
     await taskService.deleteTask(taskId);
     return true;
 }
+/**
+ * Handler for merging two tasks
+ */
+export async function mergeTaskHandler(params) {
+    try {
+        const { taskId, mergeFromId } = params;
+        if (!taskId || !mergeFromId) {
+            throw new Error('taskId and mergeFromId are required');
+        }
+        const result = await taskService.mergeTask(taskId, {
+            merge_from_id: mergeFromId
+        });
+        return sponsorService.createResponse(result, true);
+    }
+    catch (error) {
+        return sponsorService.createErrorResponse(error, params);
+    }
+}
+/**
+ * Handler for getting time in status for a task
+ */
+export async function getTimeInStatusHandler(params) {
+    try {
+        const { taskId } = params;
+        if (!taskId) {
+            throw new Error('taskId is required');
+        }
+        const result = await taskService.getTimeInStatus(taskId);
+        return sponsorService.createResponse(result, true);
+    }
+    catch (error) {
+        return sponsorService.createErrorResponse(error, params);
+    }
+}
+/**
+ * Handler for getting time in status for multiple tasks
+ */
+export async function getBulkTimeInStatusHandler(params) {
+    try {
+        const { taskIds } = params;
+        if (!taskIds || !Array.isArray(taskIds) || taskIds.length === 0) {
+            throw new Error('taskIds array is required and must not be empty');
+        }
+        const result = await taskService.getBulkTimeInStatus(taskIds);
+        return sponsorService.createResponse(result, true);
+    }
+    catch (error) {
+        return sponsorService.createErrorResponse(error, params);
+    }
+}
+/**
+ * Handler for adding a task to an additional list
+ */
+export async function addTaskToListHandler(params) {
+    try {
+        const { listId, taskId } = params;
+        if (!listId || !taskId) {
+            throw new Error('listId and taskId are required');
+        }
+        const result = await taskService.addTaskToList(listId, taskId);
+        return sponsorService.createResponse(result, true);
+    }
+    catch (error) {
+        return sponsorService.createErrorResponse(error, params);
+    }
+}
+/**
+ * Handler for removing a task from a list
+ */
+export async function removeTaskFromListHandler(params) {
+    try {
+        const { listId, taskId } = params;
+        if (!listId || !taskId) {
+            throw new Error('listId and taskId are required');
+        }
+        await taskService.removeTaskFromList(listId, taskId);
+        return sponsorService.createResponse({
+            success: true,
+            message: `Task ${taskId} removed from list ${listId}`
+        }, true);
+    }
+    catch (error) {
+        return sponsorService.createErrorResponse(error, params);
+    }
+}

package/build/tools/task/index.js

@@ -9,7 +9,7 @@
 // Re-export from main module
 export * from './main.js';
 // Re-export single task operation tools
-export { createTaskTool, getTaskTool, getTasksTool, updateTaskTool, moveTaskTool, duplicateTaskTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool } from './single-operations.js';
+export { createTaskTool, getTaskTool, getTasksTool, updateTaskTool, moveTaskTool, duplicateTaskTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool, mergeTaskTool, getTimeInStatusTool, getBulkTimeInStatusTool, addTaskToListTool, removeTaskFromListTool } from './single-operations.js';
 // Re-export bulk task operation tools
 export { createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool } from './bulk-operations.js';
 // Re-export workspace task operation tools
@@ -21,7 +21,7 @@ export { attachTaskFileTool, handleAttachTaskFile } from './attachments.js';
 // Re-export handlers
 export { 
 // Single task operation handlers
-createTaskHandler, getTaskHandler, getTasksHandler, updateTaskHandler, moveTaskHandler, duplicateTaskHandler, deleteTaskHandler, getTaskCommentsHandler, createTaskCommentHandler, 
+createTaskHandler, getTaskHandler, getTasksHandler, updateTaskHandler, moveTaskHandler, duplicateTaskHandler, deleteTaskHandler, getTaskCommentsHandler, createTaskCommentHandler, mergeTaskHandler, getTimeInStatusHandler, getBulkTimeInStatusHandler, addTaskToListHandler, removeTaskFromListHandler, 
 // Bulk task operation handlers
 createBulkTasksHandler, updateBulkTasksHandler, moveBulkTasksHandler, deleteBulkTasksHandler, 
 // Team task operation handlers

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

@@ -467,3 +467,142 @@ export const deleteTaskTool = {
         }
     }
 };
+/**
+ * Tool definition for merging two tasks
+ */
+export const mergeTaskTool = {
+    name: "merge_task",
+    description: `Merges two ClickUp tasks together. The merge_from task will be merged into the destination task.
+
+Example usage:
+{
+  "taskId": "abc123",           // Destination task ID (merge into this)
+  "mergeFromId": "xyz789"       // Source task ID (merge from this)
+}`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            taskId: {
+                type: "string",
+                description: "REQUIRED: ID of the destination task (merge into this task)"
+            },
+            mergeFromId: {
+                type: "string",
+                description: "REQUIRED: ID of the source task (merge from this task)"
+            }
+        },
+        required: ["taskId", "mergeFromId"]
+    }
+};
+/**
+ * Tool definition for getting time in status for a task
+ */
+export const getTimeInStatusTool = {
+    name: "get_task_time_in_status",
+    description: `Gets the time tracking information for how long a task has been in each status.
+
+Example usage:
+{
+  "taskId": "abc123"
+}
+
+Returns:
+- current_status: Current status with time spent
+- status_history: Array of all status changes with timestamps`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            taskId: {
+                type: "string",
+                description: "REQUIRED: ID of the task to get time in status for"
+            }
+        },
+        required: ["taskId"]
+    }
+};
+/**
+ * Tool definition for getting time in status for multiple tasks
+ */
+export const getBulkTimeInStatusTool = {
+    name: "get_bulk_tasks_time_in_status",
+    description: `Gets the time in status information for multiple tasks at once. More efficient than calling get_task_time_in_status multiple times.
+
+Example usage:
+{
+  "taskIds": ["abc123", "xyz789", "def456"]
+}
+
+Returns an object with task IDs as keys and their time in status data as values.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            taskIds: {
+                type: "array",
+                description: "REQUIRED: Array of task IDs to get time in status for",
+                items: {
+                    type: "string"
+                },
+                minItems: 1
+            }
+        },
+        required: ["taskIds"]
+    }
+};
+/**
+ * Tool definition for adding a task to an additional list
+ */
+export const addTaskToListTool = {
+    name: "add_task_to_list",
+    description: `Adds a task to an additional list, enabling multiple list membership for the task.
+
+Example usage:
+{
+  "listId": "12345",
+  "taskId": "abc123"
+}
+
+Note: This does NOT move the task. The task will belong to multiple lists after this operation.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            listId: {
+                type: "string",
+                description: "REQUIRED: ID of the list to add the task to"
+            },
+            taskId: {
+                type: "string",
+                description: "REQUIRED: ID of the task to add to the list"
+            }
+        },
+        required: ["listId", "taskId"]
+    }
+};
+/**
+ * Tool definition for removing a task from a list
+ */
+export const removeTaskFromListTool = {
+    name: "remove_task_from_list",
+    description: `Removes a task from a specific list. If the task belongs to multiple lists, it will only be removed from the specified list.
+
+Example usage:
+{
+  "listId": "12345",
+  "taskId": "abc123"
+}
+
+Warning: If this is the task's only list, the task may be deleted or moved to an archive depending on ClickUp settings.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            listId: {
+                type: "string",
+                description: "REQUIRED: ID of the list to remove the task from"
+            },
+            taskId: {
+                type: "string",
+                description: "REQUIRED: ID of the task to remove from the list"
+            }
+        },
+        required: ["listId", "taskId"]
+    }
+};

package/build/tools/workspace-helper.js

@@ -25,7 +25,10 @@ export const workspaceParameter = {
  */
 export function getServicesForWorkspace(params) {
     try {
-        return getClickUpServices(params.workspace);
+        console.error('[DEBUG] getServicesForWorkspace called with workspace:', params.workspace);
+        const services = getClickUpServices(params.workspace);
+        console.error('[DEBUG] Retrieved services for workspace:', params.workspace || 'default');
+        return services;
     }
     catch (error) {
         // Enhance error message with available workspaces

package/build/tools/workspace.js

@@ -30,6 +30,9 @@ export const workspaceHierarchyTool = {
  */
 export async function handleGetWorkspaceHierarchy(params = {}) {
     try {
+        // DEBUG: Log received parameters
+        console.error('[DEBUG] handleGetWorkspaceHierarchy called with params:', JSON.stringify(params));
+        console.error('[DEBUG] params.workspace =', params.workspace);
         // Get services for the specified workspace
         const services = getServicesForWorkspace(params);
         const { workspace: workspaceService } = services;
@@ -44,6 +47,49 @@ export async function handleGetWorkspaceHierarchy(params = {}) {
         return sponsorService.createErrorResponse(`Error getting workspace hierarchy: ${error.message}`);
     }
 }
+/**
+ * Tool definition for retrieving available workspaces
+ */
+export const availableWorkspacesTool = {
+    name: 'get_available_workspaces',
+    description: `Gets list of all available workspaces configured in the ClickUp MCP server. Returns workspace identifiers, default workspace, and descriptions if available.`,
+    inputSchema: {
+        type: 'object',
+        properties: {}
+    }
+};
+/**
+ * Handler for the get_available_workspaces tool
+ */
+export async function handleGetAvailableWorkspaces() {
+    try {
+        // Import config functions
+        const { getAvailableWorkspaces, getDefaultWorkspace, getWorkspaceConfig } = await import('../config.js');
+        // Get list of available workspace identifiers
+        const workspaceIds = getAvailableWorkspaces();
+        const defaultWorkspace = getDefaultWorkspace();
+        // Get detailed information for each workspace
+        const workspaces = workspaceIds.map(id => {
+            const config = getWorkspaceConfig(id);
+            return {
+                id,
+                teamId: config.teamId,
+                description: config.description || (id === 'default' ? 'Default workspace' : undefined),
+                isDefault: id === defaultWorkspace
+            };
+        });
+        const result = {
+            default: defaultWorkspace,
+            workspaces,
+            count: workspaces.length
+        };
+        // Use sponsor service to create the response
+        return sponsorService.createResponse(result, true);
+    }
+    catch (error) {
+        return sponsorService.createErrorResponse(`Error getting available workspaces: ${error.message}`);
+    }
+}
 /**
  * Format the hierarchy as a tree string
  */

package/build/utils/sponsor-service.js

@@ -1,37 +1,26 @@
 /**
  * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-FileCopyrightText: © 2025 Daichi Okazaki (Alanse)
  * SPDX-License-Identifier: MIT
  *
- * Sponsor Service Module
+ * Response Service Module
  *
- * Provides configuration and utilities for sponsorship functionality
+ * Provides utilities for creating standardized MCP responses
  */
 import { Logger } from '../logger.js';
-import config from '../config.js';
 // Create logger instance for this module
-const logger = new Logger('SponsorService');
+const logger = new Logger('ResponseService');
 /**
- * SponsorService - Provides sponsorship configuration and message handling
+ * ResponseService - Provides standardized response formatting
  */
-export class SponsorService {
+export class ResponseService {
     constructor() {
-        this.sponsorUrl = 'https://github.com/sponsors/taazkareem';
-        this.isEnabled = config.enableSponsorMessage;
-        logger.info('SponsorService initialized', { enabled: this.isEnabled });
+        logger.info('ResponseService initialized');
     }
     /**
-     * Get sponsor information (for documentation/reference purposes)
+     * Creates a standardized response
      */
-    getSponsorInfo() {
-        return {
-            isEnabled: this.isEnabled,
-            url: this.sponsorUrl
-        };
-    }
-    /**
-     * Creates a response with optional sponsorship message
-     */
-    createResponse(data, includeSponsorMessage = false) {
+    createResponse(data, _includeSponsorMessage = false) {
         const content = [];
         // Special handling for workspace hierarchy which contains a preformatted tree
         if (data && typeof data === 'object' && 'hierarchy' in data && typeof data.hierarchy === 'string') {
@@ -55,13 +44,6 @@ export class SponsorService {
                 text: JSON.stringify(data, null, 2)
             });
         }
-        // Then add sponsorship message if enabled
-        if (this.isEnabled && includeSponsorMessage) {
-            content.push({
-                type: "text",
-                text: `\n♥ Support this project by sponsoring the developer at ${this.sponsorUrl}`
-            });
-        }
         return { content };
     }
     /**
@@ -74,7 +56,7 @@ export class SponsorService {
         });
     }
     /**
-     * Creates a bulk operation response with sponsorship message
+     * Creates a bulk operation response
      */
     createBulkResponse(result) {
         return this.createResponse({
@@ -86,8 +68,9 @@ export class SponsorService {
                 id: failure.item?.id || failure.item,
                 error: failure.error.message
             }))
-        }, true); // Always include sponsor message for bulk operations
+        });
     }
 }
-// Export a singleton instance
-export const sponsorService = new SponsorService();
+// Export a singleton instance for backwards compatibility
+// (keeping the name 'sponsorService' to avoid changing all imports)
+export const sponsorService = new ResponseService();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alanse/clickup-multi-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "ClickUp MCP Server with Multi-Workspace Support - Integrate multiple ClickUp workspaces with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",