Skip to main content
Connect ClickUp to let 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.
Authorize exactly one ClickUp workspace. The ClickUp tools cannot switch workspaces after authorization, and a connection authorized for multiple workspaces cannot complete requests.

Setup

1

Open the connection catalog

In your CloudThinker workspace, go to Settings → Connections, select Builtin Connections, and choose ClickUp.
2

Start the OAuth flow

Click Connect to open ClickUp’s authorization page.
3

Authorize one workspace

Sign in to the ClickUp account that can access your work, select exactly one ClickUp workspace, and approve access.
4

Return to CloudThinker

CloudThinker stores the OAuth authorization and the connection shows a Connected status.

Connection details

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

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 in CloudThinker.
Authorize a ClickUp user that can access only the spaces and lists CloudThinker needs. CloudThinker cannot read or change resources that user cannot access.

Agent capabilities

Once connected, Anna can:

Verify the connection

Example prompts

Troubleshooting

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.
The connection was authorized for more than one ClickUp workspace. Disconnect ClickUp, reconnect, and select exactly one workspace during authorization.
The ClickUp access token is invalid or expired. ClickUp may not issue a refresh token for this connection, so disconnect and authorize ClickUp again.
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.
Enable the Total time in Status ClickApp in ClickUp workspace settings. Task and workload reads still work when this measurement is disabled.
The ClickUp account reached its provider quota. Wait for the ClickUp rate-limit window to reset, then retry with the same scope.

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.

Approval

Review how CloudThinker gates ClickUp changes

Anna Agent

Coordinate project work and cross-service operations