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

# ClickUp

> Connect ClickUp to CloudThinker with OAuth for workspace discovery, task triage, workload review, and approved task changes

Connect ClickUp to let [Anna](/guide/agents/anna) discover workspace structure, triage work, review workload, and investigate tasks, comments, documents, and chat. ClickUp uses **OAuth** through its hosted MCP server, so you do not paste an API token into CloudThinker.

## Prerequisites

* A **ClickUp account** with access to the workspace you want CloudThinker to use.
* Permission to authorize CloudThinker through ClickUp's OAuth flow.
* A CloudThinker workspace where ClickUp is not already connected.

<Info>
  Authorize exactly one ClickUp workspace. The ClickUp tools cannot switch workspaces after authorization, and a connection authorized for multiple workspaces cannot complete requests.
</Info>

## Setup

<Steps>
  <Step title="Open the connection catalog">
    In your CloudThinker workspace, go to **Settings → Connections**, select **Builtin Connections**, and choose **ClickUp**.
  </Step>

  <Step title="Start the OAuth flow">
    Click **Connect** to open ClickUp's authorization page.
  </Step>

  <Step title="Authorize one workspace">
    Sign in to the ClickUp account that can access your work, select exactly one ClickUp workspace, and approve access.
  </Step>

  <Step title="Return to CloudThinker">
    CloudThinker stores the OAuth authorization and the connection shows a **Connected** status.
  </Step>
</Steps>

## Connection details

ClickUp uses OAuth, so there are no credential fields to enter manually.

| Field                   | Description                                                                  |
| ----------------------- | ---------------------------------------------------------------------------- |
| **OAuth authorization** | Issued by ClickUp and stored automatically after you approve access          |
| **ClickUp workspace**   | The single workspace selected during authorization                           |
| **MCP endpoint**        | ClickUp's hosted server at `mcp.clickup.com/mcp`; fixed and not configurable |

## Required permissions

CloudThinker inherits the authorizing user's ClickUp access.

* **Read operations** cover workspace structure, tasks, comments, custom fields, workload, time entries, documents, and chat channels the user can view.
* **Write operations** cover tasks, comments, tags, and document pages. They need matching ClickUp access **and** explicit [approval](/guide/approval) in CloudThinker.

<Tip>
  Authorize a ClickUp user that can access only the spaces and lists CloudThinker needs. CloudThinker cannot read or change resources that user cannot access.
</Tip>

## Agent capabilities

Once connected, Anna can:

| Capability                        | Description                                                                                |
| --------------------------------- | ------------------------------------------------------------------------------------------ |
| **Workspace discovery**           | List spaces, folders, lists, and recent work                                               |
| **Task triage**                   | Find overdue, unassigned, and unscheduled tasks in one list                                |
| **Workload review**               | Compare open work by assignee and status, then measure status age when ClickUp provides it |
| **Task investigation**            | Read task details, custom fields, comments, and threaded discussions                       |
| **Documents and chat**            | Read document pages and chat channel messages available to the connected user              |
| **Task changes**                  | Create, update, move, or delete tasks after approval                                       |
| **Comments, tags, and documents** | Add comments, change tags, or update document pages after approval                         |

### Verify the connection

```text theme={null}
@anna #report show the ClickUp workspace structure and summarize what needs attention in Project 1
```

### Example prompts

```text theme={null}
@anna #report list overdue, unassigned, and unscheduled ClickUp tasks in Project 1
@anna #report compare open ClickUp work by assignee and status age in Team Space
@anna #recommend review the comments on the oldest overdue ClickUp task and suggest the next action
```

## Troubleshooting

<Accordion title="The OAuth flow does not complete">
  Your browser may be signed in to the wrong ClickUp account. Sign in to the account that can access the intended workspace, then start **Connect** again.
</Accordion>

<Accordion title="The agent reports multiple workspaces">
  The connection was authorized for more than one ClickUp workspace. Disconnect ClickUp, reconnect, and select exactly one workspace during authorization.
</Accordion>

<Accordion title="The connection returns 401 Unauthorized">
  The ClickUp access token is invalid or expired. ClickUp may not issue a refresh token for this connection, so disconnect and authorize ClickUp again.
</Accordion>

<Accordion title="The agent cannot find a space, list, or task">
  The authorizing user may not have access, or the resource may have moved. Confirm the user's ClickUp access, then ask the agent to discover the workspace again.
</Accordion>

<Accordion title="Status age is unavailable">
  Enable the **Total time in Status** ClickApp in ClickUp workspace settings. Task and workload reads still work when this measurement is disabled.
</Accordion>

<Accordion title="Requests return a rate-limit error">
  The ClickUp account reached its provider quota. Wait for the ClickUp rate-limit window to reset, then retry with the same scope.
</Accordion>

## Security

* **Least privilege** — grant only the permissions the agents need for your use case; start read-only and widen later.
* **Read-only by default** — use read-only credentials unless you want agents to make changes through this connection.
* **Rotate credentials** — rotate keys and tokens on your normal schedule; CloudThinker picks up the new value when you update the connection.
* **Revoke on offboarding** — remove the credential at the provider when you delete a connection or a teammate leaves.

- **Use one workspace**: authorize only the ClickUp workspace CloudThinker should reach.
- **Use least privilege**: connect a ClickUp user whose spaces and lists match the work CloudThinker should see and change.

## Related

<CardGroup cols={2}>
  <Card title="Approval" icon="shield-check" href="/guide/approval">
    Review how CloudThinker gates ClickUp changes
  </Card>

  <Card title="Anna Agent" icon="users" href="/guide/agents/anna">
    Coordinate project work and cross-service operations
  </Card>
</CardGroup>