ClickUp

Provides access to ClickUp data and actions via MCP with 170+ tools, markdown support, and secure, production-ready features.

typescript

4

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "chykalophia-clickup-mcp-server---enhanced": {
      "command": "npx",
      "args": [
        "-y",
        "@chykalophia/clickup-mcp-server"
      ],
      "env": {
        "WEBHOOK_SECRET": "whsec_abcdef123456",
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

You can deploy and run the ClickUp MCP Server to give an AI assistant complete, programmatic access to ClickUp data and actions. This server exposes a rich set of tools, supports Markdown, and includes production-ready security features. You install it, configure your client, and start querying and manipulating ClickUp data through MCP endpoints in a scalable, secure way.

How to use

Install the MCP server and run it behind your preferred MCP client. Use the client to send requests that map to ClickUp actions such as managing workspaces, spaces, tasks, comments, documents, time tracking, and more. Take advantage of intelligent discovery to find the right tools for a given task, and leverage the named tools to access specific endpoints with clear, namespaced identifiers like clickup_get_tasks or clickup_create_task. The server is designed for production use, with security checks, rate limiting, and HMAC-protected webhooks, so you can wire it into your workflows with confidence.

How to install

Prerequisites: ensure you have Node.js version 18.x or higher and npm or yarn installed on your system.

Choose one of the installation methods below and follow the steps in order.

Option 1: One--click or NPX installer is recommended for quick setup.

Option 2: Use the NPM package directly for a quick, no-build setup.

Option 3: Build from source if you want to customize or contribute.

Additional sections

Configuration and startup follow a common pattern: you provide an API token, choose how you run the MCP server, and then start serving requests through your MCP client. The following setup sections detail how to configure and run the server safely.

Security is built into the MCP server with input validation, rate limiting, HMAC validation for webhooks, and safe file handling. You will set up tokens and secrets in your environment, and ensure webhooks are authenticated before processing events.

Examples demonstrate practical usage patterns, including how to discover tools efficiently, analyze workflow efficiency, and process webhooks with security checks. These illustrate how to compose tool calls to achieve common tasks quickly.

Troubleshooting tips cover common startup issues, token validation problems, and webhook signature verification errors. Check environment variables, ensure the MCP server is reachable by your client, and verify that rate limits and security settings are correctly applied.

Available tools

clickup_get_workspaces

Retrieve the list of ClickUp workspaces available to the token holder.

clickup_get_tasks

Fetch tasks from a workspace or list with optional filters.

clickup_create_task

Create a new task in a specified list with a name and optional description.

clickup_get_task_details

Get detailed information for a specific task, including Markdown-enabled descriptions.

clickup_create_task_comment

Add a comment to a specific task, supporting Markdown content.

clickup_find_chat_channels

Discover chat channels to facilitate targeted team communication.

clickup_search_views_by_name

Search for views by name within a workspace to locate dashboards or views quickly.