@taazkareem/clickup-mcp-server 0.5.1 → 0.6.1

package/README.md

@@ -1,18 +1,12 @@
-<img src="https://clickup.com/assets/brand/logo-v3-clickup-dark.svg" alt="ClickUp" height="40" style="vertical-align: middle; margin-top: -4px;">
-
-# MCP Server
+<img src="assets/images/clickup_mcp_server_social_image.png" alt="ClickUp MCP Server" width="100%">
 
+![Total Supporters](https://img.shields.io/badge/🏆%20Total%20Supporters-2-gold)
 [![GitHub Stars](https://img.shields.io/github/stars/TaazKareem/clickup-mcp-server?style=flat&logo=github)](https://github.com/TaazKareem/clickup-mcp-server/stargazers)
-[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/TaazKareem/clickup-mcp-server/graphs/commit-activity)
+[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-brightgreen.svg)](https://github.com/TaazKareem/clickup-mcp-server/graphs/commit-activity)
 
 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.1 beta release with new Attach Task Files tool, Create Task Comments tool, Get Task Comments tool, and Custom ID support across all tools.
-
-
-
-
+> 🚧 **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
 
@@ -26,13 +20,12 @@ A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI appl
 
 [![smithery badge](https://smithery.ai/badge/@TaazKareem/clickup-mcp-server)](https://smithery.ai/server/@TaazKareem/clickup-mcp-server)
 
-The server is hosted on Smithery. There, you can preview the available tools or copy the commands to run on your specific client app. 
-
+The server is hosted on [Smithery](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/librariesio/github/TaazKareem/clickup-mcp-server)](https://libraries.io/github/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:
@@ -61,37 +54,24 @@ 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
-
-- 📂 **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
 
 | Tool | Description | Required Parameters |
 |------|-------------|-------------------|
 | [get_workspace_hierarchy](docs/api-reference.md#workspace-navigation) | Get workspace structure | None |
-| [create_task](docs/api-reference.md#task-management) | Create a task | `name`, (`listId`/`listName`) |
+| [create_task](docs/api-reference.md#task-management) | Create a task | `name`, (`listId`/`listName`), optional `parent` |
 | [create_bulk_tasks](docs/api-reference.md#task-management) | Create multiple tasks | `tasks[]` |
 | [update_task](docs/api-reference.md#task-management) | Modify task | `taskId`/`taskName` |
 | [update_bulk_tasks](docs/api-reference.md#task-management) | Update multiple tasks | `tasks[]` with IDs or names |
-| [get_tasks](docs/api-reference.md#task-management) | Get tasks from list | `listId`/`listName` |
-| [get_task](docs/api-reference.md#task-management) | Get task details | `taskId`/`taskName` |
+| [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 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`) |
@@ -109,11 +89,17 @@ 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.
 
-## Available Prompts
-Not yet implemented (or needed) For now, you can send a follow up prompt after the tool result.
+## 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:
 
 | Prompt | Purpose | Features |
 |--------|---------|----------|
@@ -131,6 +117,9 @@ The server provides clear error messages for:
 - API errors
 - Rate limiting
 
+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!
@@ -138,10 +127,12 @@ 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.
@@ -158,7 +149,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Disclaimer
 
-Disclaimer: This software makes use of third-party APIs and may reference trademarks
+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

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,16 +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',
-    sponsorUrl: process.env.SPONSOR_URL || 'https://github.com/sponsors/taazkareem'
+    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,37 +1,27 @@
-#!/usr/bin/env node
 /**
- * ClickUp MCP Server - A Model Context Protocol server for ClickUp integration
+ * SPDX-FileCopyrightText: © 2025 Talib Kareem <taazkareem@icloud.com>
+ * SPDX-License-Identifier: MIT
  *
- * This server enables AI applications to interact with ClickUp through a standardized protocol,
- * allowing AI assistants to manage tasks, lists, and folders in ClickUp workspaces.
+ * ClickUp MCP Server
  *
- * Key capabilities include:
+ * This custom server implements the Model Context Protocol (MCP) specification to enable
+ * AI applications to interact with ClickUp workspaces. It provides a standardized
+ * interface for managing tasks, lists, folders and other ClickUp entities using Natural Language.
  *
- * Task Management:
- * - Create, update, move and duplicate tasks with rich description support
- * - Find tasks by name with smart disambiguation
- * - Optimized bulk task operations with concurrent processing
- * - Comprehensive filtering and sorting options
+ * Key Features:
+ * - Complete task management (CRUD operations, moving, duplicating)
+ * - Workspace organization (spaces, folders, lists)
+ * - Bulk operations with concurrent processing
+ * - Natural language date parsing
+ * - File attachments support
+ * - Name-based entity resolution
+ * - Markdown formatting
+ * - Built-in rate limiting
  *
- * Workspace Organization:
- * - Navigate and discover workspace structure with hierarchical views
- * - Create and manage lists and folders with proper nesting
- * - Smart name-based lookups that eliminate the need for IDs
- * - Support for priorities, statuses, and due dates
- *
- * Technical Features:
- * - Full markdown support for rich text content
- * - Secure credential handling through configuration
- * - Comprehensive error reporting and validation
- * - Name-based entity resolution with fuzzy matching
- *
- * This implementation follows the Model Context Protocol specification and
- * is designed to be used with AI assistants that support MCP.
+ * 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 { clickUpServices } from "./services/shared.js";
-import { initializeWorkspaceTool } from "./tools/workspace.js";
 import { info, error, warn } from "./logger.js";
 import { exec } from 'child_process';
 import { promisify } from 'util';
@@ -76,9 +66,6 @@ async function main() {
             os: process.platform,
             arch: process.arch
         });
-        // Initialize tools with services
-        info("Initializing workspace tools");
-        initializeWorkspaceTool(clickUpServices);
         // Configure the server with all handlers
         info("Configuring server request handlers");
         await configureServer();

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,17 +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 = {}));
-// Fixed log level - always use TRACE as the minimum level for complete logging
-const configuredLevel = LogLevel.TRACE;
+// 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.5.1",
+    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: 23,
-        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
+                }
+            };
+        }
+    }
+}