Skip to main content
The clickup MCP adapter connects to the ClickUp API. List workspaces and spaces, create and update tasks, read comments, and keep project management in sync with automation — ideal for ticket routing, status updates, and agent-driven task creation.

​
Prerequisites

  • A ClickUp account with access to the target workspaces
  • A ClickUp personal API token (pk_...) from Settings → Apps
  • List and task IDs from ClickUp URLs or discovery tools
  • project_contributor access in AgentRuntime

​
Connect in AgentRuntime

1

Create a ClickUp API token

In ClickUp, go to Settings → Apps and generate a personal API token. Copy the pk_... value.
2

Create a connection

Go to Connections and click New custom connection to create an API key connection with APIKey.
3

Add clickup MCP instance

Go to MCP, click Add instance for clickup, wire your connection on Instance config, set the profile active, and save.
4

Discover IDs

Run mcp_call → clickup_get_workspaces, then clickup_get_spaces and clickup_get_list to map workspace → list IDs before hard-coding them in workflows.
See Authentication for binding connections to MCP instances.

​
What you can build

  • Support → task — Form submission or chat escalation → clickup_create_task in the support list with priority and assignees.
  • Status sync — GitLab issue closed → clickup_update_task to move ClickUp status to Done.
  • Daily standup digest — clickup_get_tasks on a sprint list → LLM summarizes blockers.
  • Comment trail — Agent adds context with clickup_create_comment; humans reply in ClickUp UI.

​
Tools

ToolDescription
clickup_get_workspacesList workspaces accessible to the token
clickup_get_spacesList non-archived spaces in a workspace
clickup_get_listGet list metadata by list ID
clickup_get_tasksList open tasks in a list (paginated)
clickup_get_taskGet a task by task ID
clickup_create_taskCreate a task with name, description, status, priority, assignees, due date
clickup_update_taskUpdate task fields and assignees
clickup_delete_taskDelete a task by ID
clickup_get_commentsList comments on a task
clickup_create_commentPost a comment on a task

​
Example

Create a task from a workflow trigger: 
{
  "id": "clickup-task",
  "type": "mcp_call",
  "name": "Create ClickUp task",
  "tool_name": "clickup_create_task",
  "tool_args": {
    "list_id": "{{input.list_id}}",
    "name": "{{input.title}}",
    "description": "{{steps.llm-draft.result.body}}",
    "priority": 2,
    "status": "to do"
  },
  "depends_on": ["llm-draft"],
  "timeout_s": 30
}

​
Configuration

KeyRequiredDescription
APIKeyYesClickUp personal API token (pk_...)
APIBaseNoClickUp API base URL

​
Troubleshooting

IssueFix
401 UnauthorizedRegenerate token; personal tokens do not expire but can be revoked
Invalid status nameStatus labels are list-specific; copy exact names from ClickUp UI
Task not visibleConfirm list ID and workspace access for the token owner
Pagination gapsUse page on clickup_get_tasks (100 tasks per page, starting at 0)