Name: ClickUp MCP
Author: taazkareem

LABSCO SUMMARY

Coverage well past task CRUD — docs, chat, sprints and time — with fuzzy name resolution so you rarely have to find an ID first.

Most ClickUp integrations stop at creating and updating tasks; here the same conversation can start a timer, post in a channel, update a doc page and adjust a goal. The search layer is what makes that pleasant: lists, folders, members, statuses and tags resolve from names, so the model is not spending turns hunting for identifiers. The trade is the licence — this one is paid, and the tool surface is large enough to be worth scoping in your client.

What it is

A broad ClickUp server covering the whole workspace hierarchy and most of what sits inside it: tasks and their relationships, lists, folders and spaces, goals, views, docs, chat, guests, webhooks and time entries.

What you get

Tasks created, read, updated, moved, duplicated and deleted, singly or in bulk, with workspace-wide task search
Everything that hangs off a task: comments with replies and reactions, checklists and their items, task links, dependencies, tags, attachments and membership of several lists at once
The hierarchy managed rather than just read — spaces, folders and lists created, updated, moved and deleted, with permissions set and creation from templates
Custom fields listed, created, and their values set or cleared on tasks
Views created and read, including pulling the tasks a view contains
Goals with their key results, kept current from the same place as the work
Sprints: the active sprint, the sprint list and the tasks in one
Time tracking end to end — start and stop the running entry, add, edit and delete entries, manage their tags, and read time-in-status history
ClickUp Docs read and written: documents listed and created, pages listed, read, created and updated
Chat as a first-class surface — channels, DMs, messages and replies, reactions, members, followers and tagged users
Administration around the edges: user groups, guests invited and attached to tasks, lists or folders, webhooks, audit logs, workspace seats and plan

Requirements

A ClickUp workspace. Authenticate with OAuth 2.1, or with the older pairing of CLICKUP_API_KEY and CLICKUP_TEAM_ID, which also supports several authorized workspaces in one session. Run from npm as @taazkareem/clickup-mcp-server. The project is proprietary rather than open source: a paid licence unlocks the full tool set, sold monthly, annually or as a one-off, with three device activations per licence.

Setup effort

One command plus a key — claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp --header "X-License-Key: your-license-key", then supply credentials

See installation options

USE CASES

Capturing work as it comes up in conversation

Create the task in the right list with its tags and custom fields, or create several at once.

create_taskcreate_bulk_tasksset_custom_field_valueadd_tag_to_task

Running the sprint

Read the active sprint and its tasks, then move or update the ones that changed.

get_active_sprintget_sprint_tasksupdate_bulk_tasksmove_task

Tracking where the time went

Start and stop the timer as you work, or add entries afterwards and tag them.

start_time_entrystop_time_entryadd_time_entryget_time_entries

Answering a question hidden in the workspace

Search across the workspace's tasks, then read the task with its comments and links.

get_workspace_tasksget_taskget_commentsget_task_links

Keeping documentation next to the work

Find the document, read the page, and update it without opening ClickUp.

list_documentsget_document_pageupdate_document_page

Setting up a new area of work

Create the space, its folders and lists — from a template where one exists — and set who can see them.

create_spacecreate_foldercreate_list_from_templateset_folder_permissions

Chasing something without switching apps

Post in the channel or DM the person, and read the replies where the answer lands.

list_chat_channelscreate_chat_messagecreate_chat_dmget_chat_message_replies

150 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`add_chat_reaction`

Add an emoji reaction to a chat message. Requires message_id + reaction emoji name.

INSTALLATION

Connect your client

Server setup

claude mcp add

Claude Code

TERMINAL

claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: <YOUR_CLICKUP_MCP_LICENSE_KEY>"

Hosted endpoint

ENDPOINT URL

https://clickup-mcp.taazkareem.com/mcp

Add this hosted endpoint to your MCP client using the credentials listed under Requirements.

MCP Clients

Antigravity — remote, Windsurf

JSON

{
  "mcpServers": {
    "ClickUp": {
      "serverUrl": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "<YOUR_CLICKUP_MCP_LICENSE_KEY>"
      }
    }
  }
}

Antigravity — stdio

ANTIGRAVITY — STDIO · JSON

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@taazkareem/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_API_KEY": "<YOUR_CLICKUP_API_KEY>",
        "CLICKUP_TEAM_ID": "<YOUR_CLICKUP_TEAM_ID>",
        "CLICKUP_MCP_LICENSE_KEY": "<YOUR_CLICKUP_MCP_LICENSE_KEY>"
      }
    }
  }
}

Hermes Agent

HERMES AGENT · TERMINAL

hermes mcp add clickup \
  --url https://clickup-mcp.taazkareem.com/mcp \
  --auth oauth
hermes config set mcp_servers.clickup.headers.X-License-Key "<YOUR_CLICKUP_MCP_LICENSE_KEY>"

OpenClaw

OPENCLAW · TERMINAL

mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp --auth oauth --header "X-License-Key=<YOUR_CLICKUP_MCP_LICENSE_KEY>"

Cursor

CURSOR · JSON

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "<YOUR_CLICKUP_MCP_LICENSE_KEY>"
      }
    }
  }
}

VS Code

VS CODE · JSON

{
  "servers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "<YOUR_CLICKUP_MCP_LICENSE_KEY>"
      }
    }
  }
}

Roo Code

ROO CODE · JSON

{
  "mcpServers": {
    "ClickUp": {
      "type": "streamable-http",
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "<YOUR_CLICKUP_MCP_LICENSE_KEY>"
      }
    }
  }
}

Claude Desktop

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://clickup-mcp.taazkareem.com/mcp",
        "--header",
        "X-License-Key: <YOUR_CLICKUP_MCP_LICENSE_KEY>"
      ]
    }
  }
}

ChatGPT

CHATGPT

Server URL: https://clickup-mcp.taazkareem.com/mcp

Auggie CLI

AUGGIE CLI · TERMINAL

auggie mcp add ClickUp --url https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: <YOUR_CLICKUP_MCP_LICENSE_KEY>"

ClickUp MCP

Coverage well past task CRUD — docs, chat, sprints and time — with fuzzy name resolution so you rarely have to find an ID first.

What it is

What you get

Requirements

Setup effort

Capturing work as it comes up in conversation

Running the sprint

Tracking where the time went

Answering a question hidden in the workspace

Keeping documentation next to the work

Setting up a new area of work

Chasing something without switching apps

150 tools

add_chat_reaction

add_comment_reaction

add_guest_to_folder

add_guest_to_list

add_guest_to_task

add_tag_to_task

add_task_dependency

add_task_link

add_task_to_list

add_time_entry

add_time_entry_tags

create_bulk_tasks

create_chat_channel

create_chat_dm

create_chat_message

create_chat_message_reply

create_checklist

create_checklist_item

create_comment

create_comment_reply

create_custom_field

create_document

create_document_page

create_folder

create_folder_from_template

create_goal

create_key_result

create_list

create_list_from_template

create_space

create_space_tag

create_task

create_task_from_template

create_user_group

create_view

create_webhook

delete_bulk_tasks

delete_chat_channel

delete_chat_message

delete_checklist

delete_checklist_item

delete_comment

delete_folder

delete_goal

delete_key_result

delete_list

delete_space

delete_space_tag

delete_task

delete_task_dependency

delete_task_link

delete_time_entry

delete_time_entry_tags

delete_user_group

delete_view

delete_webhook

duplicate_task

edit_checklist

edit_checklist_item

edit_guest

get_active_sprint

get_attachment

get_audit_logs

get_chat_channel

get_chat_channel_followers

get_chat_channel_members

`add_chat_reaction`

`add_comment_reaction`

`add_guest_to_folder`

`add_guest_to_list`

`add_guest_to_task`

`add_tag_to_task`

`add_task_dependency`

`add_task_link`

`add_task_to_list`

`add_time_entry`

`add_time_entry_tags`

`create_bulk_tasks`

`create_chat_channel`

`create_chat_dm`

`create_chat_message`

`create_chat_message_reply`

`create_checklist`

`create_checklist_item`

`create_comment`

`create_comment_reply`

`create_custom_field`

`create_document`

`create_document_page`

`create_folder`

`create_folder_from_template`

`create_goal`

`create_key_result`

`create_list`

`create_list_from_template`

`create_space`

`create_space_tag`

`create_task`

`create_task_from_template`

`create_user_group`

`create_view`

`create_webhook`

`delete_bulk_tasks`

`delete_chat_channel`

`delete_chat_message`

`delete_checklist`

`delete_checklist_item`

`delete_comment`

`delete_folder`

`delete_goal`

`delete_key_result`

`delete_list`

`delete_space`

`delete_space_tag`

`delete_task`

`delete_task_dependency`

`delete_task_link`

`delete_time_entry`

`delete_time_entry_tags`

`delete_user_group`

`delete_view`

`delete_webhook`

`duplicate_task`

`edit_checklist`

`edit_checklist_item`

`edit_guest`

`get_active_sprint`

`get_attachment`

`get_audit_logs`

`get_chat_channel`

`get_chat_channel_followers`

`get_chat_channel_members`

`get_chat_message_replies`

`get_chat_message_subtypes`

`get_chat_messages`

`get_chat_reactions`

`get_chat_tagged_users`

`get_comment_replies`

`get_comment_subtypes`

`get_comments`

`get_current_time_entry`

`get_document`

`get_document_page`

`get_document_pages`

`get_folder`

`get_goal`