Personal Task Tracking

通过本地 bash 脚本调用 ClickUp REST API，列出或统计到期、逾期与已完成任务，浏览空间和列表，按指派人创建任务并关闭任务。使用前需配置 ClickUp 凭证等三个环境变量；描述引用的 scripts/query.sh 在文件列表中缺失。

mmaggiezhou

热度 49.31

最近更新 2026-05-11 17:36:38

分类：协作依赖：代码执行 / 第三方 API应用场景：任务管理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add personal-task-tracking

Metadata

name: personal-task-tracking
description: 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.
metadata: {"openclaw":{"emoji":"⏫","requires":{"bins":["bash","curl","jq"],"env":["CLICKUP_API_KEY","CLICKUP_TEAM_ID","CLICKUP_ASSIGNEE_ID"]},"primaryEnv":"CLICKUP_API_KEY","install":[{"id":"jq-brew","kind":"brew","formula":"jq","bins":["jq"],"label":"Install jq (brew)"}]}}

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}