v0.7.2

v0.7.2 Release Notes (2025-04-25)

🛠️ Bug Fixes

• Fixed time estimate support in task updates:
  • Removed redundant field-specific validation check in task update operations
  • Simplified validation to check only for the presence of update fields
  • Fixed "At least one field to update must be provided" error when using time_estimate
  • Added time string parsing for converting formats like "2h 30m" to minutes
  • Improved tool description for clear guidance on supported formats
  • Ensures compatibility with all fields defined in the UpdateTaskData type

📦 Dependencies

• No dependency changes in this release

🙏 Thank You

Special thanks to our contributors who reported and helped fix this issue:

• @m-roberts - Reporting and suggesting fix for the time estimate update issue

Your feedback helps make ClickUp MCP Server better for everyone!

v0.7.1

v0.7.1 Release Notes (2025-04-24)

🚀 New Features & Improvements

• Added Documents Module with comprehensive capabilities:

  • Complete document lifecycle management (create, list, search, update)
  • Page-level operations for creating and modifying document content
  • Optional activation via DOCUMENT_SUPPORT=true environment variable
  • Full compatibility with ClickUp API V3 for document operations
  • Seamless integration with existing workspace navigation

• Added Time Tracking Suite with comprehensive tools:

  • View and manage time entries for tasks with flexible filtering
  • Start/stop time tracking with one command
  • Add manual time entries with natural language duration support
  • Track billable and non-billable time
  • Delete unwanted time entries
  • Monitor currently running timers across workspace

• Added Command Disabling Capability:

  • Selective tool access via DISABLED_TOOLS environment variable
  • Comma-separated command list for granular control
  • Compatible with both environment variables and command line arguments
  • Clear error messages when attempting to use disabled commands
  • Enhanced security for production deployments

🛠️ Bug Fixes & Improvements

• Fixed custom task ID lookup in getTaskByCustomId method:

  • Corrected API endpoint from /task/custom_task_ids to /task/{id} with proper parameters
  • Added required custom_task_ids=true and team_id parameters for proper authentication
  • Fixed "Authorization failed" error when retrieving tasks by custom ID
  • Improved error handling and logging for custom ID operations

• Fixed JSON schema compatibility issues for third-party integrations

• Enhanced custom field handling in task update operations

• Improved error handling and validation across all new tools

• Optimized response formatting for consistent output

📦 Dependencies

• No dependency changes in this release

🔄 Repository Updates

• Comprehensive documentation updates for all new features
• Enhanced API reference with examples for document and time tracking operations
• Added configuration guides for new environment variables
• Improved tool descriptions and parameter documentation

🙏 Thank You

Special thanks to our contributors who made this release possible:

• @jsb989 - Document support implementation
• @quitequinn - Time tracking functionality
• @somework - Tool disabling feature
• @Nemo64 - JSON schema compatibility improvements
• @FruitSwimer - Custom field update fixes

Your contributions have significantly improved the ClickUp MCP Server!

v0.7.0

v0.7.0 Release Notes (2025-04-24)

🚀 New Features & Improvements

• Added Documents Module with comprehensive capabilities:

  • Complete document lifecycle management (create, list, search, update)
  • Page-level operations for creating and modifying document content
  • Optional activation via DOCUMENT_SUPPORT=true environment variable
  • Full compatibility with ClickUp API V3 for document operations
  • Seamless integration with existing workspace navigation

• Added Time Tracking Suite with comprehensive tools:

  • View and manage time entries for tasks with flexible filtering
  • Start/stop time tracking with one command
  • Add manual time entries with natural language duration support
  • Track billable and non-billable time
  • Delete unwanted time entries
  • Monitor currently running timers across workspace

• Added Command Disabling Capability:

  • Selective tool access via DISABLED_TOOLS environment variable
  • Comma-separated command list for granular control
  • Compatible with both environment variables and command line arguments
  • Clear error messages when attempting to use disabled commands
  • Enhanced security for production deployments

🛠️ Bug Fixes & Improvements

• Fixed JSON schema compatibility issues for third-party integrations
• Enhanced custom field handling in task update operations
• Improved error handling and validation across all new tools
• Optimized response formatting for consistent output

📦 Dependencies

• No dependency changes in this release

🔄 Repository Updates

• Comprehensive documentation updates for all new features
• Enhanced API reference with examples for document and time tracking operations
• Added configuration guides for new environment variables
• Improved tool descriptions and parameter documentation

🙏 Thank You

Special thanks to our contributors who made this release possible:

• @jsb989 - Document support implementation
• @quitequinn - Time tracking functionality
• @somework - Command disabling feature
• @Nemo64 - JSON schema compatibility improvements
• @FruitSwimer - Custom field update fixes

Your contributions have significantly improved the ClickUp MCP Server!

v0.6.9

v0.6.9 Release Notes (2025-04-03)

🚀 New Features & Improvements

• Enhanced token limit protection for workspace tasks:
  • Added handler-level token limit validation with 50,000 token threshold
  • Implemented dual-layer protection at both service and handler levels
  • Smart response format switching based on estimated response size
  • Automatic fallback to summary format for large responses
  • Added token estimation utilities for accurate size prediction
  • Improved logging for format switching events
  • Zero configuration required - works automatically
  • Maintains backward compatibility with existing implementations

📦 Dependencies

• No dependency changes in this release

🔄 Repository Updates

• Updated task handler implementation with token limit checks
• Added token estimation utilities for task responses
• Enhanced documentation with token limit behavior details

v0.6.0

v0.6.0 Release Notes (2025-03-26)

🚀 New Features & Improvements

• Added subtasks support with multi-level nesting capability

  • Create subtasks by setting the parent parameter with parent task ID
  • Retrieve subtasks using the subtasks parameter on get_task and get_tasks operations
  • Support nested subtasks (subtasks of subtasks)

• Made logging level configurable and improved logging system

  • Configure via LOG_LEVEL environment variable or command line argument
  • Default log level now set to ERROR for better compatibility with tools like Cline
  • Support for TRACE, DEBUG, INFO, WARN, and ERROR levels

• Fixed custom task ID handling across all operations

  • Improved support for retrieving tasks using custom ID format (e.g., "DEV-1234")
  • Fixed comparison issues with custom ID validation

📦 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: Add configurable log levels
• #20: Fix custom task ID handling

Thanks to @colinmollenhour for the logging and custom ID fixes on this one 🎉

ClickUp MCP Server v0.5.1

v0.5.1 Release Notes

🚀 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 (in addition to hours, days, months)
• 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