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

# ClickUp

> Manage tasks, lists, and spaces in ClickUp workspaces

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Docs**: [https://developer.clickup.com/docs/authentication](https://developer.clickup.com/docs/authentication)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                | Required | Description                                                                                                                    |
| ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `CLICKUP_CLIENT_ID`     | Yes      | ClickUp OAuth Client ID (from your OAuth app in workspace settings) [Docs](https://developer.clickup.com/docs/authentication). |
| `CLICKUP_CLIENT_SECRET` | Yes      | ClickUp OAuth Client Secret [Docs](https://developer.clickup.com/docs/authentication).                                         |

## Setup

1. **Create a ClickUp OAuth app**: Sign in to ClickUp (a Free Forever workspace works), open your avatar menu → Settings → ClickUp API, and click Create an App.
2. **Set the redirect URL**: Set the app's redirect URL to your app URL ending in /api/auth/clickup/callback.
3. **Copy credentials**: Copy the generated Client ID and Client Secret into CLICKUP\_CLIENT\_ID and CLICKUP\_CLIENT\_SECRET.
4. **Verify access**: Connect your ClickUp account and run the List Workspaces tool.

* ClickUp OAuth has no scopes; users pick which Workspaces to authorize during the consent screen
* OAuth access tokens currently do not expire and no refresh tokens are issued
* OAuth access tokens are sent as Authorization: Bearer \<token>; only personal pk\_ tokens use the bare-token header

Provider API reference: [https://developer.clickup.com/reference](https://developer.clickup.com/reference)

## Tools

| Tool            | Access | Description                                                    |
| --------------- | ------ | -------------------------------------------------------------- |
| List Workspaces | Read   | List ClickUp Workspaces (teams) the authorized user can access |
| List Spaces     | Read   | List Spaces in a ClickUp Workspace                             |
| List Lists      | Read   | List folderless Lists in a ClickUp Space                       |
| List Tasks      | Read   | List tasks in a ClickUp List                                   |
| Get Task        | Read   | Get details of a ClickUp task                                  |
| Create Task     | Write  | Create a new task in a ClickUp List                            |
| Update Task     | Write  | Update fields on an existing ClickUp task                      |

## Example prompts

* List the open tasks in a ClickUp list with their statuses and due dates.
* Create a new ClickUp task with a name, description, priority, and due date.