Skip to main content

At a glance

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

  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

Tools

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.