ClickUp
ClickUp project management integration for workspaces, tasks, time tracking, and custom fields
The ClickUp integration lets your agents manage workspaces, spaces, folders, lists, and tasks. It also supports comments, tags, time tracking, and custom fields.
You need one of the following:
- Personal API Token — Generate one from your ClickUp Settings under Apps > API Token. Tokens start with
pk_.
- OAuth — For user-level access where each chat user authorizes with their own ClickUp account.
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select ClickUp from the integration list
- Give the config a display name (e.g., "ClickUp")
- Choose your authentication method:
- Personal API Token — Paste your ClickUp API token
- OAuth — Click Connect to start the ClickUp OAuth flow
- Save the agent revision
- In an Agent Step, attach ClickUp tools from the tools panel
- The agent uses your integration config for all ClickUp API calls
- Tools are referenced as
clickup.list_tasks, clickup.create_task, etc.
| Tool | Description | Action Type |
|---|
list_workspaces | List all workspaces the user has access to | ReadOnly |
| Tool | Description | Action Type |
|---|
list_spaces | List all spaces in a workspace | ReadOnly |
get_space | Get details of a specific space | ReadOnly |
create_space | Create a new space in a workspace | Reversible |
delete_space | Permanently delete a space | Irreversible |
| Tool | Description | Action Type |
|---|
list_folders | List all folders in a space | ReadOnly |
create_folder | Create a new folder in a space | Reversible |
delete_folder | Permanently delete a folder | Irreversible |
| Tool | Description | Action Type |
|---|
list_lists | List all lists in a folder | ReadOnly |
list_folderless_lists | List lists in a space not inside any folder | ReadOnly |
get_list | Get details of a specific list | ReadOnly |
create_list | Create a new list in a folder | Reversible |
delete_list | Permanently delete a list | Irreversible |
| Tool | Description | Action Type |
|---|
list_tasks | List tasks with filters for status, assignees, and date ranges | ReadOnly |
get_task | Get full task details including custom fields and subtasks | ReadOnly |
create_task | Create a task with name, description, status, priority, and assignees | Reversible |
update_task | Update a task's name, status, priority, or due date | Reversible |
delete_task | Permanently delete a task | Irreversible |
| Tool | Description | Action Type |
|---|
list_task_comments | List the 25 most recent comments on a task | ReadOnly |
create_task_comment | Add a comment to a task | Reversible |
| Tool | Description | Action Type |
|---|
list_tags | List all tags available in a space | ReadOnly |
| Tool | Description | Action Type |
|---|
list_time_entries | List time entries with optional date range and assignee filters | ReadOnly |
create_time_entry | Create a time tracking entry, optionally attached to a task | Reversible |
| Tool | Description | Action Type |
|---|
list_custom_fields | List all custom fields on a list | ReadOnly |
set_custom_field_value | Set the value of a custom field on a task | Reversible |
