From clickup-pack
Lists ClickUp workspaces, spaces, lists, and creates tasks via API v2 curl commands. For starting integrations, testing auth, or learning hierarchy (Workspace > Space > List > Task).
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin clickup-packThis skill is limited to using the following tools:
Walk through the ClickUp hierarchy and make your first API calls. ClickUp's data model: **Workspace** (called "team" in API v2) > **Space** > **Folder** (optional) > **List** > **Task**.
Manages ClickUp tasks via API v2: create, read, update, delete with assignees, priorities, due dates, subtasks, statuses, tags, and custom fields. Triggers on 'clickup task' phrases.
Interacts with ClickUp REST API to manage tasks, spaces, lists, assignees. Handles pagination, subtasks for reporting, automation, and workflow queries.
Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.
Share bugs, ideas, or general feedback.
Walk through the ClickUp hierarchy and make your first API calls. ClickUp's data model: Workspace (called "team" in API v2) > Space > Folder (optional) > List > Task.
clickup-install-auth setupCLICKUP_API_TOKEN in environmentWorkspace (team_id) GET /api/v2/team
└── Space (space_id) GET /api/v2/team/{team_id}/space
├── List GET /api/v2/space/{space_id}/list (folderless lists)
└── Folder GET /api/v2/space/{space_id}/folder
└── List GET /api/v2/folder/{folder_id}/list
└── Task GET /api/v2/list/{list_id}/task
# Get authorized workspaces (returns team_id needed for all subsequent calls)
curl -s https://api.clickup.com/api/v2/team \
-H "Authorization: $CLICKUP_API_TOKEN" | jq '.teams[] | {id, name}'
Response shape:
{
"teams": [{
"id": "1234567",
"name": "My Workspace",
"color": "#536cfe",
"members": [{ "user": { "id": 123, "username": "john", "email": "john@example.com" } }]
}]
}
TEAM_ID="1234567"
curl -s "https://api.clickup.com/api/v2/team/${TEAM_ID}/space?archived=false" \
-H "Authorization: $CLICKUP_API_TOKEN" | jq '.spaces[] | {id, name}'
SPACE_ID="12345678"
# Folderless lists (directly in Space)
curl -s "https://api.clickup.com/api/v2/space/${SPACE_ID}/list" \
-H "Authorization: $CLICKUP_API_TOKEN" | jq '.lists[] | {id, name}'
# Or lists inside folders
curl -s "https://api.clickup.com/api/v2/space/${SPACE_ID}/folder" \
-H "Authorization: $CLICKUP_API_TOKEN" | jq '.folders[] | {id, name, lists: [.lists[] | {id, name}]}'
LIST_ID="900100200300"
curl -s -X POST "https://api.clickup.com/api/v2/list/${LIST_ID}/task" \
-H "Authorization: $CLICKUP_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Hello from the ClickUp API!",
"description": "Created via API v2",
"priority": 3,
"status": "to do"
}' | jq '{id, name, url}'
// TypeScript equivalent
async function createFirstTask(listId: string) {
const task = await clickupRequest(`/list/${listId}/task`, {
method: 'POST',
body: JSON.stringify({
name: 'Hello from the ClickUp API!',
description: 'Created via API v2',
priority: 3, // 1=Urgent, 2=High, 3=Normal, 4=Low
status: 'to do',
assignees: [123456], // user IDs (optional)
due_date: Date.now() + 86400000, // tomorrow (Unix ms)
due_date_time: true,
}),
});
console.log(`Task created: ${task.name} (${task.id})`);
console.log(`URL: ${task.url}`);
return task;
}
{
"id": "abc123",
"custom_id": null,
"name": "Hello from the ClickUp API!",
"status": { "status": "to do", "color": "#d3d3d3", "type": "open" },
"priority": { "id": "3", "priority": "normal", "color": "#6fddff" },
"date_created": "1695000000000",
"date_updated": "1695000000000",
"due_date": "1695086400000",
"url": "https://app.clickup.com/t/abc123",
"list": { "id": "900100200300", "name": "My List" },
"folder": { "id": "456", "name": "My Folder" },
"space": { "id": "12345678" }
}
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Missing/invalid token | Check CLICKUP_API_TOKEN |
| 404 Not Found | Invalid list_id/team_id | Verify IDs via GET /team |
| 400 Bad Request | Missing name field | Task name is required |
| 429 Rate Limited | Too many requests | Wait for X-RateLimit-Reset |
Proceed to clickup-core-workflow-a for workspace/space/task management patterns.