How to Connect ClickUp to an AI Agent
Auth setup
1. Settings > Apps > Generate API Token (personal). 2. Use Authorization: {token} (no Bearer prefix!). 3. For OAuth: register app, get client_id/secret, redirect flow.
Key facts
| Base URL | https://api.clickup.com/api/v2/ |
|---|
| API version | v2 |
|---|
| Auth | OAuth 2.0 or personal API token. Personal token for quick setup — generate in Settings > Apps. OAuth for production integrations. |
|---|
| Token URL | https://api.clickup.com/api/v2/oauth/token |
|---|
| Request body | application/json |
|---|
| Pagination | page parameter (0-indexed). Response returns tasks array — empty array means no more pages. |
|---|
| Rate limit | 100 req/min per token. 429 with Retry-After header. |
|---|
| Error format | JSON: {"err":"...","ECODE":"..."} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /team | Get workspace info |
POST | /list/{id}/task | Create a task in a list |
GET | /task/{id} | Get task details |
PUT | /task/{id} | Update a task |
GET | /team/{id}/space | Get spaces in workspace |
Quickstart
GET /api/v2/team
Authorization: {personal_token}
Response: {"teams":[{"id":"...","name":"My Workspace",...}]}
Agent pitfalls & tips
- Auth header is Authorization: {token} — NO 'Bearer' prefix for personal tokens.
- Hierarchy: Workspace > Space > Folder > List > Task. Navigate top-down.
- Custom fields are in custom_fields array — use field ID, not name, for updates.
- Use include_subtasks=true query param to get subtasks in task lists.
- Webhooks available for real-time updates — register via POST /team/{id}/webhook.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-07. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is ClickUp's AEO score?
▼
ClickUp has an AEO score of 0.60 and is rated BBB (Basic agent connectivity available). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is ClickUp AI-agent-ready?
▼
ClickUp is currently connectable for AI agent use. API access is available but no dedicated MCP server has been published yet. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does ClickUp compare to other Project Management services?
▼
In the Project Management category, ClickUp is rated BBB. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how ClickUp compares.
How can I integrate ClickUp with an AI agent?
▼
The fastest way to integrate ClickUp with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with ClickUp?
▼
OAuth 2.0 or personal API token. Personal token for quick setup — generate in Settings > Apps. OAuth for production integrations. Setup: 1. Settings > Apps > Generate API Token (personal). 2. Use Authorization: {token} (no Bearer prefix!). 3. For OAuth: register app, get client_id/secret, redirect flow.
What are ClickUp's API rate limits?
▼
100 req/min per token. 429 with Retry-After header.