@taazkareem/clickup-mcp-server 0.6.0 → 0.6.1

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.5.2 release with new Attach Task Files tool, Create Task Comments tool, Get Task Comments tool, Custom ID support across all tools, and Subtasks support.
+> 🚧 **Status Update:** Rolling out v0.6.1 which will add Complete Tag Support including natural language tag color commands, Subtasks Support, Custom ID Support, and Logging Fixes
 
 ## Setup
 
@@ -22,7 +22,6 @@ A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI appl
 
 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)
@@ -55,26 +54,11 @@ Or use this npx command:
 
 ## Features
 
-- 🎯 **Task Management**
-  - Create, retrieve, update, and delete tasks
-  - Move and duplicate tasks between lists, spaces, and folders
-  - Single operation or bulk operation
-  - View and modify task details and properties
-  - Get task comments
-  - Set due dates using natural language and relative time expressions
-  - Attach files to tasks using local file paths, URL, base64, or chunked uploads
-  - Create and manage subtasks with support for multi-level nesting
-
-- 📂 **Workspace Organization**
-  - Complete workspace hierarchy (spaces, folders, lists)
-  - Tree structure with clear relationships
-  - Efficient path-based navigation
-
-- 🔄 **Integration Features**
-  - Name or ID-based item lookup
-  - Case-insensitive name matching
-  - Markdown formatting support
-  - Built-in API rate limiting
+| 📝 Task Management | 🏷️ Tag Management |
+|----------------------------|----------------------------|
+| • Create, update, and delete tasks<br>• Move and duplicate tasks anywhere<br>• Support for single and bulk operations<br>• Set 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 |
+| 🌳 **Workspace Organization** | ⚡ **Integration Features** |
+| • 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 | • 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 |
 
 ## Available Tools
 
@@ -86,7 +70,8 @@ Or use this npx command:
 | [update_task](docs/api-reference.md#task-management) | Modify task | `taskId`/`taskName` |
 | [update_bulk_tasks](docs/api-reference.md#task-management) | Update multiple tasks | `tasks[]` with IDs or names |
 | [get_tasks](docs/api-reference.md#task-management) | Get tasks from list | `listId`/`listName`, optional `subtasks` |
-| [get_task](docs/api-reference.md#task-management) | Get task details | `taskId`/`taskName`, optional `subtasks` |
+| [get_task](docs/api-reference.md#task-management) | Get single task details | `taskId`/`taskName`, optional `subtasks` |
+| [get_workspace_tasks](docs/api-reference.md#task-management) | Get tasks with filtering | At least one filter (tags, list_ids, space_ids, etc.) |
 | [get_task_comments](docs/api-reference.md#task-management) | Get comments on a task | `taskId`/`taskName` |
 | [create_task_comment](docs/api-reference.md#task-management) | Add a comment to a task | `commentText`, (`taskId`/(`taskName`+`listName`)) |
 | [attach_task_file](docs/api-reference.md#task-management) | Attach file to a task | `taskId`/`taskName`, (`file_data` or `file_url`) |
@@ -104,6 +89,12 @@ Or use this npx command:
 | [get_list](docs/api-reference.md#list-management) | Get list details | `listId`/`listName` |
 | [update_list](docs/api-reference.md#list-management) | Update list properties | `listId`/`listName` |
 | [delete_list](docs/api-reference.md#list-management) | Delete list | `listId`/`listName` |
+| [get_space_tags](docs/api-reference.md#tag-management) | Get space tags | `spaceId`/`spaceName` |
+| [create_space_tag](docs/api-reference.md#tag-management) | Create tag | `tagName`, `spaceId`/`spaceName` |
+| [update_space_tag](docs/api-reference.md#tag-management) | Update tag | `tagName`, `spaceId`/`spaceName` |
+| [delete_space_tag](docs/api-reference.md#tag-management) | Delete tag | `tagName`, `spaceId`/`spaceName` |
+| [add_tag_to_task](docs/api-reference.md#tag-management) | Add tag to task | `tagName`, `taskId`/(`taskName`+`listName`) |
+| [remove_tag_from_task](docs/api-reference.md#tag-management) | Remove tag from task | `tagName`, `taskId`/(`taskName`+`listName`) |
 
 See [full documentation](docs/api-reference.md) for optional parameters and advanced usage.
 

package/build/config.js

@@ -1,5 +1,8 @@
 /**
- * Configuration handling for ClickUp API credentials
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
+ * Configuration handling for ClickUp API credentials and application settings
  *
  * The required environment variables (CLICKUP_API_KEY and CLICKUP_TEAM_ID) are passed
  * securely to this file when running the hosted server at smithery.ai. Optionally,
@@ -15,15 +18,44 @@ for (let i = 0; i < args.length; i++) {
             envArgs.clickupApiKey = value;
         if (key === 'CLICKUP_TEAM_ID')
             envArgs.clickupTeamId = value;
+        if (key === 'LOG_LEVEL')
+            envArgs.logLevel = value;
         i++;
     }
 }
+// Log levels enum
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["TRACE"] = 0] = "TRACE";
+    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARN"] = 3] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+// Parse LOG_LEVEL string to LogLevel enum
+export const parseLogLevel = (levelStr) => {
+    if (!levelStr)
+        return LogLevel.ERROR; // Default to ERROR if not specified
+    switch (levelStr.toUpperCase()) {
+        case 'TRACE': return LogLevel.TRACE;
+        case 'DEBUG': return LogLevel.DEBUG;
+        case 'INFO': return LogLevel.INFO;
+        case 'WARN': return LogLevel.WARN;
+        case 'ERROR': return LogLevel.ERROR;
+        default:
+            console.error(`Invalid LOG_LEVEL: ${levelStr}, defaulting to ERROR`);
+            return LogLevel.ERROR;
+    }
+};
 // Load configuration from command line args or environment variables
 const configuration = {
     clickupApiKey: envArgs.clickupApiKey || process.env.CLICKUP_API_KEY || '',
     clickupTeamId: envArgs.clickupTeamId || process.env.CLICKUP_TEAM_ID || '',
-    enableSponsorMessage: process.env.ENABLE_SPONSOR_MESSAGE !== 'false'
+    enableSponsorMessage: process.env.ENABLE_SPONSOR_MESSAGE !== 'false',
+    logLevel: parseLogLevel(envArgs.logLevel || process.env.LOG_LEVEL)
 };
+// Log the configured log level (but only to console to avoid circular dependency)
+console.debug(`Log level set to: ${LogLevel[configuration.logLevel]}`);
 // Validate only the required variables are present
 const requiredVars = ['clickupApiKey', 'clickupTeamId'];
 const missingEnvVars = requiredVars

package/build/index.js

@@ -1,5 +1,7 @@
-#!/usr/bin/env node
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp MCP Server
  *
  * This custom server implements the Model Context Protocol (MCP) specification to enable

package/build/logger.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * Logger module for MCP Server
  *
  * This module provides logging functionality for the server,
@@ -7,6 +10,7 @@
 import { createWriteStream } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import config, { LogLevel } from './config.js';
 // Get the directory name of the current module
 const __dirname = dirname(fileURLToPath(import.meta.url));
 // Current process ID for logging
@@ -15,44 +19,10 @@ const pid = process.pid;
 const logFileName = 'server.log';
 const logStream = createWriteStream(join(__dirname, logFileName), { flags: 'w' });
 console.error(`Logging to ${join(__dirname, logFileName)}`);
-// Log levels with numeric values for filtering
-export var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["TRACE"] = 0] = "TRACE";
-    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
-    LogLevel[LogLevel["INFO"] = 2] = "INFO";
-    LogLevel[LogLevel["WARN"] = 3] = "WARN";
-    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
-})(LogLevel || (LogLevel = {}));
-// Parse LOG_LEVEL environment variable or command line argument
-const parseLogLevel = (levelStr) => {
-    if (!levelStr)
-        return LogLevel.ERROR; // Default to ERROR if not specified
-    switch (levelStr.toUpperCase()) {
-        case 'TRACE': return LogLevel.TRACE;
-        case 'DEBUG': return LogLevel.DEBUG;
-        case 'INFO': return LogLevel.INFO;
-        case 'WARN': return LogLevel.WARN;
-        case 'ERROR': return LogLevel.ERROR;
-        default:
-            console.error(`Invalid LOG_LEVEL: ${levelStr}, defaulting to ERROR`);
-            return LogLevel.ERROR;
-    }
-};
-// Parse command line arguments for LOG_LEVEL
-const args = process.argv.slice(2);
-let argLogLevel;
-for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--env' && i + 1 < args.length) {
-        const [key, value] = args[i + 1].split('=');
-        if (key === 'LOG_LEVEL')
-            argLogLevel = value;
-        i++;
-    }
-}
-// Get log level from environment variable or command line, default to ERROR
-const configuredLevel = parseLogLevel(argLogLevel || process.env.LOG_LEVEL);
-console.debug(`Log level set to: ${LogLevel[configuredLevel]}`);
+// Use the configured log level from config.ts
+const configuredLevel = config.logLevel;
+// Re-export LogLevel enum
+export { LogLevel };
 /**
  * Check if a log level is enabled based on the configured level
  * @param level The log level to check

package/build/server.js

@@ -1,21 +1,25 @@
+/**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
+ * MCP Server for ClickUp integration
+ */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { workspaceHierarchyTool, handleGetWorkspaceHierarchy } from "./tools/workspace.js";
-import { createTaskTool, updateTaskTool, moveTaskTool, duplicateTaskTool, getTaskTool, getTasksTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool, createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool, attachTaskFileTool, handleCreateTask, handleUpdateTask, handleMoveTask, handleDuplicateTask, handleGetTasks, handleDeleteTask, handleGetTaskComments, handleCreateTaskComment, handleCreateBulkTasks, handleUpdateBulkTasks, handleMoveBulkTasks, handleDeleteBulkTasks, handleGetTask, handleAttachTaskFile } from "./tools/task/index.js";
+import { createTaskTool, updateTaskTool, moveTaskTool, duplicateTaskTool, getTaskTool, getTasksTool, deleteTaskTool, getTaskCommentsTool, createTaskCommentTool, createBulkTasksTool, updateBulkTasksTool, moveBulkTasksTool, deleteBulkTasksTool, attachTaskFileTool, getWorkspaceTasksTool, handleCreateTask, handleUpdateTask, handleMoveTask, handleDuplicateTask, handleGetTasks, handleDeleteTask, handleGetTaskComments, handleCreateTaskComment, handleCreateBulkTasks, handleUpdateBulkTasks, handleMoveBulkTasks, handleDeleteBulkTasks, handleGetTask, handleAttachTaskFile, handleGetWorkspaceTasks } 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, createSpaceTagTool, handleCreateSpaceTag, updateSpaceTagTool, handleUpdateSpaceTag, deleteSpaceTagTool, handleDeleteSpaceTag, addTagToTaskTool, handleAddTagToTask, removeTagFromTaskTool, handleRemoveTagFromTask } from "./tools/tag.js";
 import { Logger } from "./logger.js";
 import { clickUpServices } from "./services/shared.js";
 // Create a logger instance for server
 const logger = new Logger('Server');
 // Use existing services from shared module instead of creating new ones
 const { workspace } = clickUpServices;
-/**
- * MCP Server for ClickUp integration
- */
 export const server = new Server({
     name: "clickup-mcp-server",
-    version: "0.6.0",
+    version: "0.6.1",
 }, {
     capabilities: {
         tools: {},
@@ -47,6 +51,7 @@ export function configureServer() {
                 updateBulkTasksTool,
                 moveBulkTasksTool,
                 deleteBulkTasksTool,
+                getWorkspaceTasksTool,
                 createListTool,
                 createListInFolderTool,
                 getListTool,
@@ -55,14 +60,20 @@ export function configureServer() {
                 createFolderTool,
                 getFolderTool,
                 updateFolderTool,
-                deleteFolderTool
+                deleteFolderTool,
+                getSpaceTagsTool,
+                createSpaceTagTool,
+                updateSpaceTagTool,
+                deleteSpaceTagTool,
+                addTagToTaskTool,
+                removeTagFromTaskTool
             ]
         };
     });
     // Register CallTool handler with proper logging
     logger.info("Registering tool handlers", {
-        toolCount: 24,
-        categories: ["workspace", "task", "list", "folder"]
+        toolCount: 31,
+        categories: ["workspace", "task", "list", "folder", "tag"]
     });
     server.setRequestHandler(CallToolRequestSchema, async (req) => {
         const { name, arguments: params } = req.params;
@@ -103,6 +114,8 @@ export function configureServer() {
                     return handleMoveBulkTasks(params);
                 case "delete_bulk_tasks":
                     return handleDeleteBulkTasks(params);
+                case "get_workspace_tasks":
+                    return handleGetWorkspaceTasks(params);
                 case "create_list":
                     return handleCreateList(params);
                 case "create_list_in_folder":
@@ -121,6 +134,18 @@ export function configureServer() {
                     return handleUpdateFolder(params);
                 case "delete_folder":
                     return handleDeleteFolder(params);
+                case "get_space_tags":
+                    return handleGetSpaceTags(params);
+                case "create_space_tag":
+                    return handleCreateSpaceTag(params);
+                case "update_space_tag":
+                    return handleUpdateSpaceTag(params);
+                case "delete_space_tag":
+                    return handleDeleteSpaceTag(params);
+                case "add_tag_to_task":
+                    return handleAddTagToTask(params);
+                case "remove_tag_from_task":
+                    return handleRemoveTagFromTask(params);
                 default:
                     logger.error(`Unknown tool requested: ${name}`);
                     throw new Error(`Unknown tool: ${name}`);

package/build/services/clickup/base.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * Base ClickUp Service Class
  *
  * This class provides core functionality for all ClickUp service modules:

package/build/services/clickup/bulk.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp Bulk Service
  *
  * Enhanced implementation for bulk operations that leverages the existing single-operation methods.

package/build/services/clickup/folder.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp Folder Service
  *
  * Handles all operations related to folders in ClickUp, including:

package/build/services/clickup/index.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp Service Entry Point
  *
  * This file re-exports all service modules for the ClickUp API integration.
@@ -13,11 +16,13 @@ export { WorkspaceService } from './workspace.js';
 export { TaskService } from './task.js';
 export { ListService } from './list.js';
 export { FolderService } from './folder.js';
+export { ClickUpTagService } from './tag.js';
 // Import service classes for the factory function
 import { WorkspaceService } from './workspace.js';
 import { TaskService } from './task.js';
 import { ListService } from './list.js';
 import { FolderService } from './folder.js';
+import { ClickUpTagService } from './tag.js';
 import { Logger } from '../../logger.js';
 // Singleton logger for ClickUp services
 const logger = new Logger('ClickUpServices');
@@ -43,11 +48,14 @@ export function createClickUpServices(config) {
     const listService = new ListService(apiKey, teamId, baseUrl, workspaceService);
     logger.info('Initializing ClickUp Folder service');
     const folderService = new FolderService(apiKey, teamId, baseUrl, workspaceService);
+    logger.info('Initializing ClickUp Tag service');
+    const tagService = new ClickUpTagService(apiKey, teamId, baseUrl);
     const services = {
         workspace: workspaceService,
         task: taskService,
         list: listService,
-        folder: folderService
+        folder: folderService,
+        tag: tagService
     };
     // Log successful completion
     logger.info('All ClickUp services initialized successfully', {

package/build/services/clickup/list.js

@@ -1,4 +1,7 @@
 /**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
  * ClickUp List Service
  *
  * Handles all operations related to lists in ClickUp, including:

package/build/services/clickup/tag.js

@@ -0,0 +1,190 @@
+/**
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
+ *
+ * ClickUp Tag Service
+ *
+ * Provides access to ClickUp API endpoints for tag management:
+ * - Space tags (get, create, update, delete)
+ * - Task tags (add, remove)
+ */
+import { BaseClickUpService } from './base.js';
+/**
+ * ClickUp Tag Service class for managing tags
+ */
+export class ClickUpTagService extends BaseClickUpService {
+    /**
+     * Get all tags in a space
+     * @param spaceId - ID of the space to get tags from
+     * @returns Promise with tags array
+     */
+    async getSpaceTags(spaceId) {
+        try {
+            this.logger.debug(`Getting tags for space: ${spaceId}`);
+            const response = await this.client.get(`/space/${spaceId}/tag`);
+            return {
+                success: true,
+                data: response.data.tags
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to get tags for space: ${spaceId}`, error);
+            return {
+                success: false,
+                error: {
+                    message: error.message || 'Failed to get space tags',
+                    code: error.code,
+                    details: error.data
+                }
+            };
+        }
+    }
+    /**
+     * Create a new tag in a space
+     * @param spaceId - ID of the space
+     * @param tagData - Tag data (name, background color, foreground color)
+     * @returns Promise with created tag
+     */
+    async createSpaceTag(spaceId, tagData) {
+        try {
+            this.logger.debug(`Creating tag "${tagData.tag_name}" in space: ${spaceId}`);
+            // Send tag data wrapped in a 'tag' object
+            const response = await this.client.post(`/space/${spaceId}/tag`, {
+                tag: {
+                    name: tagData.tag_name,
+                    tag_bg: tagData.tag_bg,
+                    tag_fg: tagData.tag_fg
+                }
+            });
+            return {
+                success: true,
+                data: response.data.tag
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to create tag in space: ${spaceId}`, error);
+            return {
+                success: false,
+                error: {
+                    message: error.message || 'Failed to create space tag',
+                    code: error.code,
+                    details: error.data
+                }
+            };
+        }
+    }
+    /**
+     * Update an existing tag in a space
+     * @param spaceId - ID of the space
+     * @param tagName - Current name of the tag to update
+     * @param updateData - Tag data to update (name, colors)
+     * @returns Promise with updated tag
+     */
+    async updateSpaceTag(spaceId, tagName, updateData) {
+        try {
+            this.logger.debug(`Updating tag "${tagName}" in space: ${spaceId}`);
+            // Encode the tag name in the URL
+            const encodedTagName = encodeURIComponent(tagName);
+            const response = await this.client.put(`/space/${spaceId}/tag/${encodedTagName}`, updateData);
+            return {
+                success: true,
+                data: response.data.tag
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to update tag "${tagName}" in space: ${spaceId}`, error);
+            return {
+                success: false,
+                error: {
+                    message: error.message || 'Failed to update space tag',
+                    code: error.code,
+                    details: error.data
+                }
+            };
+        }
+    }
+    /**
+     * Delete a tag from a space
+     * @param spaceId - ID of the space
+     * @param tagName - Name of the tag to delete
+     * @returns Promise with success status
+     */
+    async deleteSpaceTag(spaceId, tagName) {
+        try {
+            this.logger.debug(`Deleting tag "${tagName}" from space: ${spaceId}`);
+            // Encode the tag name in the URL
+            const encodedTagName = encodeURIComponent(tagName);
+            await this.client.delete(`/space/${spaceId}/tag/${encodedTagName}`);
+            return {
+                success: true
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to delete tag "${tagName}" from space: ${spaceId}`, error);
+            return {
+                success: false,
+                error: {
+                    message: error.message || 'Failed to delete space tag',
+                    code: error.code,
+                    details: error.data
+                }
+            };
+        }
+    }
+    /**
+     * Add a tag to a task
+     * @param taskId - ID of the task
+     * @param tagName - Name of the tag to add
+     * @returns Promise with success status
+     */
+    async addTagToTask(taskId, tagName) {
+        try {
+            this.logger.debug(`Adding tag "${tagName}" to task: ${taskId}`);
+            // Encode the tag name in the URL
+            const encodedTagName = encodeURIComponent(tagName);
+            await this.client.post(`/task/${taskId}/tag/${encodedTagName}`, {});
+            return {
+                success: true
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to add tag "${tagName}" to task: ${taskId}`, error);
+            return {
+                success: false,
+                error: {
+                    message: error.message || 'Failed to add tag to task',
+                    code: error.code,
+                    details: error.data
+                }
+            };
+        }
+    }
+    /**
+     * Remove a tag from a task
+     * @param taskId - ID of the task
+     * @param tagName - Name of the tag to remove
+     * @returns Promise with success status
+     */
+    async removeTagFromTask(taskId, tagName) {
+        try {
+            this.logger.debug(`Removing tag "${tagName}" from task: ${taskId}`);
+            // Encode the tag name in the URL
+            const encodedTagName = encodeURIComponent(tagName);
+            await this.client.delete(`/task/${taskId}/tag/${encodedTagName}`);
+            return {
+                success: true
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to remove tag "${tagName}" from task: ${taskId}`, error);
+            return {
+                success: false,
+                error: {
+                    message: error.message || 'Failed to remove tag from task',
+                    code: error.code,
+                    details: error.data
+                }
+            };
+        }
+    }
+}