ClickUp MCP Server

by taazkareem
Verified
# Changelog ## v0.6.4 (2025-03-28) - Added start date support for tasks: - Set task start dates with natural language expressions (e.g., "now", "tomorrow at 9am") - Support for both creation and updates via `startDate` parameter - Proper time handling with `start_date_time` flag - Added Global Task Lookup feature: - Find tasks by name across the entire workspace without specifying a list - Smart disambiguation when multiple tasks share the same name - Context-aware results showing list, folder, and space for each match - Default selection of most recently updated task when multiple matches exist - Backward compatible with list-specific lookups - Applied to all task operations: get_task, update_task, delete_task, etc. - Improved error messages with actionable information for disambiguation ### 🚀 Performance Optimizations - Implemented parallel request optimization for task operations: - Parallel validation of tasks and lists in move operations - Concurrent processing of task and list data - Added task validation caching: - 5-minute TTL cache for task and list validations - Reduced redundant API calls in bulk operations - Optimized cache updates after successful operations - Enhanced workspace hierarchy fetching: - Implemented batched space processing (3 spaces at a time) - Added batched folder processing (5 folders at a time) - Improved rate limit compliance with controlled concurrency - Added detailed performance logging and metrics ## v0.6.2 (2025-03-27) ### 🛠️ Bug Fixes - Fixed binary execution issue by adding proper shebang line to the main executable ### 🚀 New Features & Improvements - Added tag support with tools for: - Managing tags at the space level (get, create, update, delete) - Adding/removing tags from tasks - Support for tags when creating and updating tasks - Enhanced bulk task creation with tags support - Added natural language color processing for tags: - Create tags with color names (e.g., "blue", "red", "yellow") - Support for color variations (e.g., "dark blue", "light green") - Automatic generation of contrasting foreground colors - Color commands in both tag creation and updates - Added `get_workspace_tasks` tool for retrieving filtered workspace tasks by various criteria: - Requires at least one filter parameter (tags, list_ids, space_ids, etc.) - Supports filtering by tags, due dates, status, and more - Includes pagination and sorting options - Implements Adaptive Response Format with two detail levels: - `summary`: Lightweight response with essential task information - `detailed`: Complete task information with all fields (default) - Automatic format selection based on response size (50,000 token threshold) - Optimized for handling large datasets efficiently ### 🔄 Repository Updates - Updated documentation to reflect new tool requirements and capabilities - Improved API reference with detailed examples and response formats ## v0.6.0 (2025-03-26) ### 🚀 New Features & Improvements - Added subtasks support with multi-level nesting capability - Implemented parent parameter for creating subtasks - Made logging level configurable via environment variable or command line - Fixed custom task ID handling across all operations - Default log level now set to ERROR for improved compatibility ### 📦 Dependencies - No dependency changes in this release ### 🔄 Repository Updates - Updated documentation for subtasks feature - Improved API reference with subtasks examples - Added Security Policy and Code of Conduct ### 🔗 References - #18: [See pull request](https://github.com/taazkareem/clickup-mcp-server/pull/18) - #20: [See pull request](https://github.com/taazkareem/clickup-mcp-server/pull/20) ## v0.5.1 (2025-03-23) ### 🚀 New Features & Improvements - Added support for Custom IDs across all tools - New tools: - `attach_task_file`: Attach files to tasks using local paths, URLs, or base64 data - `create_task_comment`: Add comments to tasks - `get_task_comments`: Retrieve comments from tasks - Enhanced date parsing with support for "X minutes from now" expressions - Improved task name matching with greater flexibility: - Case-insensitive matching - Partial name matching - Matching without emojis - Fixed error response formatting in task comment retrieval - Improved workspace hierarchy display to correctly show lists directly in spaces ### 📦 Dependencies - Updated dependencies to use semantic versioning - Upgraded: - @modelcontextprotocol/sdk: 0.6.0 → 0.6.1 - axios: 1.6.7 → 1.8.4 - dotenv: 16.4.1 → 16.4.7 ### 🔄 Repository Updates - Added automated changelog generation - Updated documentation and README - Added funding options through GitHub Sponsors and Buy Me A Coffee ## v0.5.0 (2025-03-22) ### 🚀 Initial Release - First public version of ClickUp MCP Server - Core functionality for task, list, and folder management - Basic workspace hierarchy navigation - NPM and Smithery deployment options ### 🔄 Repository Updates - Initial README and documentation - Added GitHub workflow for publishing - Created Funding options through GitHub Sponsors and Buy Me a Coffee ### 🔗 References - #12: [See pull request](https://github.com/taazkareem/clickup-mcp-server/pull/12)