Source Code

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
`your-email@example.com`	Human	Tasks for you to do manually
`ai-assistant@example.com`	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

test-manager