At a glance
- Availability: Experimental (how to enable).
- Auth: OAuth 2.0.
- Connection: A user authorizes the connection in the provider’s consent screen.
- Docs: https://developer.clickup.com/docs/authentication
Credentials
Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.Setup
- 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.
- Set the redirect URL: Set the app’s redirect URL to your app URL ending in /api/auth/clickup/callback.
- Copy credentials: Copy the generated Client ID and Client Secret into CLICKUP_CLIENT_ID and CLICKUP_CLIENT_SECRET.
- 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
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.