| name | clickup-create-task |
| description | Create ClickUp tasks with optional subtasks via LocalApiServer |
| allowed-tools | Bash |
| disable-model-invocation | true |
Create ClickUp Task
When to Use
- User asks to create a ClickUp task
- Plan requires task creation with subtasks
Prerequisites
VS Code setting switchboard.apiToken must be configured with your API token.
Usage
CUR="$PWD"
while [ "$CUR" != "/" ] && [ ! -d "$CUR/.agents/skills" ]; do CUR=$(dirname "$CUR"); done
source "$CUR/.agents/skills/_lib/sb_api_call.sh"
sb_api_call POST /task/clickup \
-H "Content-Type: application/json" \
-d '{
"name": "Task name",
"listId": "list123",
"description": "Task description",
"assignees": [12345],
"dueDate": "2025-12-31",
"subtasks": [
{"name": "Subtask 1"},
{"name": "Subtask 2", "description": "Details"}
]
}'
Parameters
- name (required): Task name
- listId (required): ClickUp list ID
- description (optional): Task description
- assignees (optional): Array of user IDs
- dueDate (optional): Due date in YYYY-MM-DD format
- subtasks (optional): Array of subtask objects (name required, others optional)
Response
{
"success": true,
"task": { "id": "...", "name": "..." },
"subtasks": [...],
"subtaskCount": 2,
"failedSubtasks": []
}
Error Handling
- 401 Unauthorized: Token not configured
- 400 Bad Request: Missing name or listId
- 503: ClickUp service unavailable