ClickUp

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider's consent screen.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

VariableRequiredDescription
CLICKUP_CLIENT_IDYesClickUp OAuth Client ID (from your OAuth app in workspace settings) Docs.
CLICKUP_CLIENT_SECRETYesClickUp OAuth Client Secret Docs.

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.

Provider notes

  • 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.

Tools

ToolAccessDescription
List Workspaces<br /><code className="reference-identifier">clickup__list_workspaces</code>ReadList workspaces
List Spaces<br /><code className="reference-identifier">clickup__list_spaces</code>ReadList spaces
List Lists<br /><code className="reference-identifier">clickup__list_lists</code>ReadList lists
List Tasks<br /><code className="reference-identifier">clickup__list_tasks</code>ReadList tasks
Get Task<br /><code className="reference-identifier">clickup__get_task</code>ReadGet task
Create Task<br /><code className="reference-identifier">clickup__create_task</code>WriteCreate task
Update Task<br /><code className="reference-identifier">clickup__update_task</code>WriteUpdate task

Verify the connection

Call a read tool such as clickup__list_workspaces with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.