ClickUp
Connects to the ClickUp API for managing tasks, lists, and spaces. An agent can create, read, update, list, and delete tasks, and list spaces in a workspace.
Add to an agent node's tools array with _node_type: "tool-clickup". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
api_token | Yes (or token) | ClickUp API token, sent as the Authorization header. |
token | Fallback | Used if api_token is not set. |
team_id | No | ClickUp workspace (team) ID, used as the default for clickup_list_spaces if not provided per-call. |
{
"name": "clickup",
"_node_type": "tool-clickup",
"api_token": "{{ secret.CLICKUP_API_TOKEN }}",
"team_id": "9000000000"
}
Tools
clickup_create_task
Create a new task in a ClickUp list.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | List ID to create task in |
name | string | Yes | Task name |
description | string | No | Task description |
status | string | No | Task status (e.g. to do, in progress, done) |
priority | number | No | Priority 1=urgent 2=high 3=normal 4=low |
assignees | string | No | Comma-separated user IDs to assign |
due_date | string | No | Due date as Unix timestamp ms or ISO date |
Returns: A confirmation message with the new task's ID, name and URL.
clickup_get_task
Get details of a ClickUp task.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | Task ID |
Returns: The raw JSON response for the task.
clickup_update_task
Update a ClickUp task.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | Task ID |
name | string | No | New task name |
description | string | No | New description |
status | string | No | New status |
priority | number | No | New priority |
Returns: A confirmation message with the task's ID and updated status.
clickup_list_tasks
List tasks in a ClickUp list.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
list_id | string | Yes | List ID |
page | number | No | Page number (0-based) |
archived | boolean | No | Include archived tasks |
Returns: A count line followed by a newline-separated list of [id] name (status) lines.
clickup_delete_task
Delete a ClickUp task.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | Task ID |
Returns: A confirmation message that the task was deleted.
clickup_list_spaces
List spaces in a ClickUp workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id | string | No | Team/workspace ID (overrides the team_id credential) |
Returns: A newline-separated list of [id] name lines. Returns an error if no team_id is available from either the parameter or credentials.