Demerzels-lab ClickUp Integration
Credentials
Note: Configure your credentials in TOOLS.md or set environment variables:
CLICKUP_API_TOKEN- Your ClickUp API tokenCLICKUP_WORKSPACE_ID- Your ClickUp workspace ID
User Assignment Guide
When assigning tasks, use the correct email based on who should do the work:
| 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