> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp

> Connect ClickUp to your Atako agents — 17 read and 22 write actions.

Let your agents manage your ClickUp workspace — create and update tasks, lists, comments, goals and time entries on your behalf.

## Connection

* **Authentication**: API key (Personal API token (pk\_...)).

<Note>
  ClickUp → click your avatar (bottom-left) → Settings → Apps → API Token → Generate (then Copy). The personal token starts with pk\_ and inherits your account permissions — no scope selection is needed.

  See [ClickUp's documentation](https://app.clickup.com/settings/apps).
</Note>

## Read actions (17)

| Action                  | Description                                                                          |
| ----------------------- | ------------------------------------------------------------------------------------ |
| `get_folder`            | Fetch a single Folder by id.                                                         |
| `get_goal`              | Fetch a single Goal with its targets (key results).                                  |
| `get_list`              | Fetch a single List by id (statuses, due date, priority).                            |
| `get_space`             | Fetch a single Space by id.                                                          |
| `get_task`              | Fetch a single task by id, optionally with its subtasks.                             |
| `get_time_entry`        | Fetch a single time entry by id.                                                     |
| `get_user`              | Get the authenticated user's profile (id, username, email).                          |
| `list_comments`         | List the comments on a task (newest first, paginated via start/start\_id).           |
| `list_folderless_lists` | List the folderless Lists attached directly to a Space.                              |
| `list_folders`          | List the Folders in a Space.                                                         |
| `list_goals`            | List the Goals of a Workspace.                                                       |
| `list_lists`            | List the Lists inside a Folder.                                                      |
| `list_spaces`           | List the Spaces of a Workspace.                                                      |
| `list_tasks`            | List the tasks in a List (paginated, 100 per page).                                  |
| `list_time_entries`     | List time entries in a Workspace within a date range (defaults to the last 30 days). |
| `list_workspaces`       | List the Workspaces (teams) the token can access, with their members.                |
| `search_tasks`          | Search tasks across a whole Workspace with filters (paginated).                      |

## Write actions (22)

| Action                   | Description                                                                 |
| ------------------------ | --------------------------------------------------------------------------- |
| `create_comment`         | Add a comment to a task.                                                    |
| `create_folder`          | Create a Folder in a Space.                                                 |
| `create_folderless_list` | Create a List directly in a Space (outside any Folder).                     |
| `create_goal`            | Create a Goal in a Workspace.                                               |
| `create_list`            | Create a List inside a Folder.                                              |
| `create_space`           | Create a new Space in a Workspace.                                          |
| `create_task`            | Create a task in a List.                                                    |
| `create_time_entry`      | Log a time entry (start timestamp + duration, optionally linked to a task). |
| `delete_comment`         | Delete a comment.                                                           |
| `delete_folder`          | Permanently delete a Folder and its Lists.                                  |
| `delete_goal`            | Permanently delete a Goal.                                                  |
| `delete_list`            | Permanently delete a List and its tasks.                                    |
| `delete_space`           | Permanently delete a Space and everything inside it.                        |
| `delete_task`            | Permanently delete a task.                                                  |
| `delete_time_entry`      | Delete a time entry.                                                        |
| `update_comment`         | Edit a comment's text or resolve it.                                        |
| `update_folder`          | Rename a Folder.                                                            |
| `update_goal`            | Update a Goal's name, description, due date or color.                       |
| `update_list`            | Update a List's name, description, due date or priority.                    |
| `update_space`           | Rename a Space or change its color/privacy settings.                        |
| `update_task`            | Update a task's name, description, status, priority or dates.               |
| `update_time_entry`      | Update a time entry's start, duration, description or linked task.          |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.