Personal Task Tracking
Query and manage ClickUp via REST API and the local scripts/query.sh helper. Use when listing open or completed tasks, counting due work, looking up spaces or lists, checking assignee workload, fetching task details, creating tasks, or closing tasks in ClickUp.
ClickUp Skill
Interact with ClickUp's REST API for task management, reporting, and workflow automation.
Configuration
Before using this skill, ensure the following are configured:
- API Token:
CLICKUP_API_KEY - Team/Workspace ID:
CLICKUP_TEAM_ID - Task Assignee ID:
CLICKUP_ASSIGNEE_ID
Check if they are available as environment variables:
echo $CLICKUP_API_KEY
echo $CLICKUP_TEAM_ID
echo $CLICKUP_ASSIGNEE_ID
If not available, export them as environment variables.
export CLICKUP_API_KEY={value}
export CLICKUP_TEAM_ID={value}
export CLICKUP_ASSIGNEE_ID={value}
Quick Start
Using the Helper Script
The fastest way to query ClickUp:
# Set environment variables
export CLICKUP_API_KEY="pk_..."
export CLICKUP_TEAM_ID="..."
export CLICKUP_ASSIGNEE_ID="..."
# Get open tasks due or overdue by a given end time
./scripts/clickup-query.sh tasks --end "2026-03-28 17:00"
# Get task counts for open tasks due or overdue by a given end time
./scripts/clickup-query.sh task-count --end "2026-03-28 17:00"
# Get tasks completed during a time window
./scripts/clickup-query.sh completed-tasks --start "2026-03-24" --end "2026-03-28 17:00"
# Get spaces under the team
./scripts/clickup-query.sh spaces
# Get lists under a space_id
./scripts/clickup-query.sh lists 123456
# Create a task with given title and due date, assign to CLICKUP_ASSIGNEE_ID, under a list_id
./scripts/clickup-query.sh create-task {list_id} "Follow up with customer" "2026-03-28 17:00"
# Close a task with task_id
./scripts/clickup-query.sh close-task 86e0jmdfe
Direct API Calls
For custom queries or operations not covered by the helper script. Example:
# Get all open tasks (with subtasks and pagination)
curl "https://api.clickup.com/api/v2/team/{team_id}/task?include_closed=false&subtasks=true" \
-H "Authorization: {api_key}"
Common Operations
Get open tasks due or overdue by a given end time
# Using helper script
./scripts/clickup-query.sh tasks --end "2026-03-28 17:00"
Get Task Counts due or overdue by a given end time
# Using helper script
./scripts/clickup-query.sh task-count --end "2026-03-28 17:00"
Create a Task with given title and due date
step 1. Get all list
# Using helper script
./scripts/clickup-query.sh spaces
./scripts/clickup-query.sh lists {space_id}
Step 2: Choose a list that's most relevant to the task Step 3: Create the task
# Using helper script
./scripts/clickup-query.sh create-task {list_id} "Follow up with customer" "2026-03-28 17:00"
Close a Task
# Using helper script
./scripts/clickup-query.sh close-task {task_id}
Related skills
- Downloads
- 970All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.1
- License
- MIT-0
