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.
Agent capabilities
Once connected, Anna can:Verify the connection
Example prompts
Troubleshooting
The OAuth flow does not complete
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.
The agent reports multiple workspaces
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.
The agent cannot find a space, list, or task
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.
Requests return a rate-limit error
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.
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
Approval
Review how CloudThinker gates ClickUp changes
Anna Agent
Coordinate project work and cross-service operations