clickup

name	clickup
description	Interact with ClickUp API for task management. Use for listing tasks, creating tasks, updating task status, and managing workspaces. Base URL: https://api.clickup.com/api/v2

ClickUp Integration

Credentials

Note: Configure your credentials in TOOLS.md or set environment variables:

• CLICKUP_API_TOKEN - Your ClickUp API token
• CLICKUP_WORKSPACE_ID - Your ClickUp workspace ID

User Assignment Guide

When assigning tasks, use the correct email based on who should do the work:

Email	Who	Use When
[e-mail]	Human	Tasks for you to do manually
[e-mail]	AI Assistant	Tasks for AI to execute
Both emails	Both Human + AI	Collaborative tasks where AI does research/writing, human reviews/decides

Examples

• AI-only task: "Research trend detection tools" → Assign to AI email
• Human-only task: "Record video for YouTube" → Assign to your email
• Collaborative: "Create content strategy" → Assign to both

Common Actions

List Tasks in a List

GET https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}

Get All Tasks in Workspace

GET https://api.clickup.com/api/v2/team/{workspace_id}/task
Authorization: {your_api_token}

Create Task

POST https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}
Content-Type: application/json

{
  "name": "Task name",
  "description": "Task description",
  "status": "active"
}

Update Task Status

PUT https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}
Content-Type: application/json

{
  "status": "done"
}

Get Task Details

GET https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}

Headers for All Requests

Authorization: {your_api_token}
Content-Type: application/json

Status Values

Common statuses: active, pending, review, completed, done

Error Handling

• 401: Check API token
• 404: Verify list_id or task_id exists
• 429: Rate limited - wait before retrying