用途:通过 ClickUp REST API 管理任务、生成报表并自动化工作流,适用于任务查询、负责人统计、状态审计和任务创建更新。
主要能力:提供辅助脚本 scripts/clickup-query.sh 执行常用操作,如 tasks(获取所有未关闭任务)、task-count(父任务与子任务计数)、assignees(按负责人统计)、task <task-id>(获取指定任务)。也可直接调用 API 自定义查询。支持按 space_ids、list 过滤,include_closed 包含已关闭任务,assignees[] 按用户 ID 过滤。
使用方式:先在 TOOLS.md 配置 CLICKUP_API_KEY 和 CLICKUP_TEAM_ID,可选 space/list ID。环境变量示例:export CLICKUP_API_KEY="pk_...";export CLICKUP_TEAM_ID="90161392624"。常用命令:./scripts/clickup-query.sh tasks。直接查询示例:curl "https://api.clickup.com/api/v2/team/{team_id}/task?include_closed=false&subtasks=true" -H "Authorization: {api_key}"。创建任务:curl "https://api.clickup.com/api/v2/list/{list_id}/task" -X POST -H "Authorization: {api_key}" -H "Content-Type: application/json" -d '{...}'。更新任务用 PUT /task/{task_id}。
关键规则:查询必须带 subtasks=true;每页最多 100 条,需循环至 last_page: true;父任务 parent=null,子任务 parent!=null。
限制与排错:缺少 subtasks=true 会遗漏大量任务;仅返回 100 条通常需分页;401 检查 API Key;速率限制约 100 请求/分钟;负责人过滤须用 user ID 参数而非文本匹配。详细接口参考请阅读 references/api-guide.md。