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 Integrations from the sidebar
- Select ClickUp from the catalog
- Click Add Integration Config
- 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 config
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach ClickUp tools from the tools panel
- 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 |
