Change Log

This document provides a chronological record of all notable changes to ClickUp MCP Server.

[0.1.0] - 2025-11-23

Support basic ClickUp MCP features (first minor release) 🍻

🎉 New feature

1. Support complete golden user journeys for ClickUp MCP server.
   1. Implement the API clients with complete features for the MCP tools.
   2. Add the MCP tools.
      1. ClickUp team level features (get info only)
      2. ClickUp workspace level features (get info only)
      3. ClickUp space level features (get, create, update, delete)
      4. ClickUp folder level features (get, create, update, delete)
      5. ClickUp list level features (get, create, update, delete)
      6. ClickUp task level features (get, create, update, delete)
2. Support basic user journeys for ClickUp webhook features in the MCP server.
   1. Implement the webhook endpoint for ClickUp service.
   2. Provide the webhook event handlers.
      1. Provide the Pythonic style webhook event handlers.
      2. Provide the OOP style webhook event handlers.
   3. Implement the message queue components for the MCP server.

🪲 Bug Fix

🙋‍♂️ For production

1. 💣 Critical bugs: (0)
   1. NaN
2. 🦠 Major bugs: (1)
   1. It only accepts to load the secret info from the command line option --token. (PR#208)
3. 🐛 Mirror bugs: (0)
   1. NaN

👨‍💻 For development

1. Use the incorrect APIs to get the ClickUp API specification configuration. (PR#187, PR#192).
2. CI workflow cannot upload README info to Docker Hub. (PR#142)

🍀 Improvement

1. Extract the long and big content about CI/CD workflows as a single section. (PR#122)
2. Add a new CI workflow checks the documentation building process. (PR#144)
3. Align all the workflows to reuse the GitHub Action reusable workflow repo. (PR#157)
4. Fix all the warnings in the documentation building. (PR#160)
5. Align the document content about the changes of aligning to reuse the GitHub Action reusable workflow repo. (PR#161)

🤖 Upgrade dependencies

1. Upgrade the Python dependencies.
2. Upgrade pre-commit dependencies.
3. Upgrade the CI reusable workflows.

[0.0.1] - 2025-09-04

Newborn of ClickUp MCP server project 🍻

🎉 New feature

• Newborn of ClickUp MCP server project.

  >>> clickup-mcp-server --help
  usage: clickup-mcp-server [-h] [--host HOST] [--port PORT] [--log-level {debug,info,warning,error,critical}] [--reload] [--env ENV_FILE] [--token TOKEN]
                            [--transport {sse,http-streaming}]
  
  Run the ClickUp MCP FastAPI server
  
  options:
    -h, --help            show this help message and exit
    --host HOST           Host to bind the server to
    --port PORT           Port to bind the server to
    --log-level {debug,info,warning,error,critical}
                          Logging level
    --reload              Enable auto-reload for development
    --env ENV_FILE        Path to the .env file for environment variables
    --token TOKEN         ClickUp API token (overrides token from .env file if provided)
    --transport {sse,http-streaming}
                          Transport protocol to use for MCP (sse or http-streaming)

👨‍💻 For development

• Provide the development details in documentation.

📑 Docs

• Provide the details in documentation.