ClickUp
Connect ClickUp to manage tasks, lists, folders, spaces, custom fields, goals, time tracking, docs, and chat.
You paste one value into PopMCP: your ClickUp Personal API Token, a single string beginning with pk_.
- Setup time
- 2 min
- Auth
- API credentials
- API base URL
- https://api.clickup.com/api/v2
- Rate limits
- 100 requests per minute per token on Free Forever, Unlimited and Business. 1,000/min on Business Plus and 10,000/min on Enterprise.
Before you begin
- Any ClickUp account, including Free Forever
- Membership of every Workspace you want the MCP to reach. A personal token carries your own access and nothing more.
- No admin role required. Anyone with a ClickUp login can generate a personal token.
Get your credentials
Open your personal settings
Sign in at app.clickup.com and click your avatar in the top-right corner. Choose Settings.
Open Apps in the settings sidebar
Under My Settings in the sidebar, click Apps. The API Token block sits at the top of the page.
Apps
Personal API tokens and the OAuth apps you have built.
| App | Client ID | Status | Created |
|---|---|---|---|
| Acme ReportingOAuth app | AB12CD****EF34 | Active | Jan 18, 2026 |
OAuth apps listed here are separate from the personal token above.
Generate and copy the token
Click Generate, or Regenerate if a token already exists. Click Copy to put the pk_ value on your clipboard.
Apps
Personal API tokens and the OAuth apps you have built.
- Prefix
- pk_
- Expires
- Never
- Scope
- Your ClickUp user, all Workspaces you belong to
Regenerating invalidates the previous token the moment the new one appears.
Paste the token into PopMCP
In PopMCP, paste the value into API token and click Save.
Connect in PopMCP
Open your workspace, choose ClickUp in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API tokensecret | In ClickUp, open your avatar (top-right) → Settings → Apps → API Token, then Generate (or copy) your Personal API Token. It starts with pk_. An OAuth2 access token works here too. Stored encrypted; used server-side only.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against ClickUp immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows the ClickUp connection as Connected and the workspace picker fills with the ClickUp Workspaces your account belongs to.
Troubleshooting
There is no API Token block on the settings page
Why: You opened Workspace settings from the Workspace avatar in the top-left. The personal token lives in your own settings.
Fix: Open **Settings** from your avatar in the top-right, then click **Apps** in the sidebar.
401 with `Token not found` or `OAUTH_017`
Why: The token was pasted with a `Bearer ` prefix, or truncated when copied.
Fix: Re-copy with the **Copy** button and paste the raw value. It must start with `pk_` and contain no spaces. ClickUp expects the raw token in the `Authorization` header with no prefix, which PopMCP handles.
`Team not authorized` on some Spaces or Lists
Why: Personal tokens only reach Workspaces your own user is a member of.
Fix: Have a Workspace owner invite your user, or generate the token from an account that already has access.
429 Too Many Requests
Why: You crossed the per-token per-minute rate limit for your plan.
Fix: Wait for the window in the `X-RateLimit-Reset` header and reduce polling frequency in your automations.
The token stopped working overnight
Why: Somebody clicked **Regenerate**, which invalidates the previous token instantly.
Fix: Generate a fresh token and paste the new value into PopMCP.