ClickUp

Connect ClickUp data with AI applications through a dedicated MCP server. This server exposes ClickUp tasks, spaces, lists, and folders via a standardized Model Context Protocol (MCP), enabling your AI agents to read, modify, and organize your ClickUp workspace with natural workflows and tool-like capabilities.

How to use

You run a ClickUp MCP server and connect it to your MCP client. The client can request actions such as creating tasks, updating lists, attaching files, or organizing workspace structure. You can tailor which tools are exposed using environment controls, and you can enable HTTP streamable transport for real-time interactions or fall back to legacy SSE for compatibility. Start the server, point your client to the server, and begin issuing high‑level actions to manage ClickUp data through the MCP interface.

How to install

Prerequisites: Node.js version 18.0.0 or higher. You also need a ClickUp API key and your Team ID from ClickUp.

Install via NPX (recommended for quick setup). Use this MCP client setting in your app or run it directly with NPX.

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@taazkareem/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "DOCUMENT_SUPPORT": "true"
      }
    }
  }
}

Additional sections

Configuration covers which tools are available, security options, and how to run with different transports. The server can enable an HTTP Streamable transport (MCP Inspector compatible) or legacy Server-Sent Events (SSE). You can also enable security enhancements such as HTTPS, origin validation, and rate limiting as opt-in features.

To run with SSE, you can start the server and use an SSE client to interact with the exposed tools. The server exposes a comprehensive set of ClickUp-related actions, including task management, workspace navigation, tag handling, document work, and more.

For local testing, you can start a sample client in a separate terminal and connect to the server to exercise end-to-end interactions.

Available tools

get_workspace_hierarchy

Get the structure of your ClickUp workspace including spaces, folders, and lists.

get_workspace_members

Retrieve all members within the ClickUp workspace.

find_member_by_name

Find a member by name or email address.

create_task

Create a new task with specified attributes.

create_bulk_tasks

Create multiple tasks in a single call.

update_task

Modify properties of an existing task.

update_bulk_tasks

Update several tasks in one operation.

get_tasks

Fetch tasks from a specific list with optional filters.

get_task

Retrieve details for a single task.

get_workspace_tasks

Get tasks across a workspace with filtering options.

delete_task

Remove a task from ClickUp.

move_task

Move a task to a different list or location.

duplicate_task

Copy a task to create a duplicate.

add_task_link

Link two tasks to represent relationships.

get_task_comments

Fetch comments associated with a task.

create_task_comment

Add a comment to a task.

attach_task_file

Attach a file to a task.

create_list

Create a new list within a space or folder.

create_folder

Create a new folder in the workspace.

get_folder

Retrieve details about a folder.

update_folder

Update folder properties.

get_space_tags

List tags available in a space.

create_space_tag

Create a new tag in the workspace.

add_tag_to_task

Associate a tag with a task.

start_time_tracking

Start a timer for a task.

stop_time_tracking

Stop the current time tracking session.

get_task_time_entries

Fetch time entries for a task.

create_document

Create a ClickUp document.

get_document

Retrieve a document.

list_documents

List documents in the workspace.

create_chat_channel

Create a new chat channel.

create_chat_message

Post a message to a chat channel.

get_chat_messages

Read message history from a channel.