ClickUp MCP server for AI agents

Browse ClickUp workspaces, spaces and lists, and create, update and comment on tasks.

Auth
API key
Tools
12
Triggers
0
Category
Project management, Productivity
Connect ClickUp clickup.com

Tools and triggers

  • Get the authorized user

    CLICKUP_GET_AUTHORIZED_USER

    Returns the ClickUp user the token belongs to.read-only

  • List workspaces

    CLICKUP_LIST_WORKSPACES

    Lists the workspaces (ClickUp calls them teams) the user belongs to, with their ids and members.read-only

  • List spaces

    CLICKUP_LIST_SPACES

    Lists the spaces of a workspace.read-only

  • List folders

    CLICKUP_LIST_FOLDERS

    Lists the folders of a space, each with its lists.read-only

  • List lists

    CLICKUP_LIST_LISTS

    Lists the lists inside a folder, or the folderless lists of a space when `space_id` is given instead.read-only

  • List tasks

    CLICKUP_LIST_TASKS

    Lists the tasks in a list, 100 per page. Closed tasks are left out unless `include_closed` is true.read-only

  • Get a task

    CLICKUP_GET_TASK

    Returns one task: status, assignees, priority, due date, tags and description.read-only

  • Create a task

    CLICKUP_CREATE_TASK

    Creates a task in a list. Priority is 1 (urgent), 2 (high), 3 (normal) or 4 (low). Dates are Unix milliseconds.

  • Update a task

    CLICKUP_UPDATE_TASK

    Changes a task's name, description, status, priority or due date. Fields left out stay as they are.destructive

  • Delete a task

    CLICKUP_DELETE_TASK

    Permanently deletes a task.destructive

  • Add a comment

    CLICKUP_ADD_COMMENT

    Posts a comment on a task.

  • List comments

    CLICKUP_LIST_COMMENTS

    Lists the comments on a task, newest first.read-only

Connect via MCP

Create an MCP server for ClickUp in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.

terminal
claude mcp add --transport http clickup \
  "https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
  --header "x-api-key: ptm_…"

Connect via REST

Run a tool with one request. The response is { data, error, successful, log_id } for every tool.

terminal
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/CLICKUP_GET_AUTHORIZED_USER \
  -H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
  -d '{ "user_id": "alice", "arguments": {} }'

ClickUp questions

Other toolkits