personal-task-tracking

# 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: ```bash echo $CLICKUP_API_KEY echo $CLICKUP_TEAM_ID echo $CLICKUP_ASSIGNEE_ID ``` If not available, export them as environment variables. ```bash 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: ```bash # 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: ```bash # 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 ```bash # 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 ```bash # 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 ```bash # 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 ```bash # Using helper script ./scripts/clickup-query.sh create-task {list_id} "Follow up with customer" "2026-03-28 17:00" ``` ### Close a Task ```bash # Using helper script ./scripts/clickup-query.sh close-task {task_id} ```