用途:通过 clickup-pp-cli 二进制脚本化访问 ClickUp v2 与 v3 全部 API(约 172 个端点),覆盖任务、空间、文件夹、列表、目标、时间追踪、Webhook、评论、自定义字段、成员、模板、视图,以及 v3 的 Chat、Docs、审计日志与 ACL。
主要能力:sync 按依赖顺序遍历完整工作区层级(团队→空间→文件夹→列表→任务;团队→文档;团队→频道)写入本地 SQLite,支持离线搜索与分析;docs、chat 提供惯用动词别名(search、get、pages、create、edit、send、react、reply 等约 22 个);task attach 以 multipart/form-data 上传本地文件,task attachments 列出附件及评论计数;analytics 基于本地库聚合,无需再调 API。
使用方式:先安装并验证。npx -y @mvanhorn/printing-press-library install clickup --cli-only,然后 clickup-pp-cli --version;失败可回退 go install github.com/mvanhorn/printing-press-library/library/project-management/clickup/cmd/clickup-pp-cli@latest。认证通过 CLICKUP_AUTHORIZATION_TOKEN 或 ~/.config/clickup-pp-cli/config.toml 设置,用 doctor 验证。任意命令加 --agent 展开为 --json --compact --no-input --no-color --yes;--select 裁剪字段,--dry-run 预览,--deliver 支持 stdout、file:<path>、webhook:<url>。可用 which 以自然语言查找命令,profile 保存常用参数组合。MCP 注册:claude mcp add clickup-pp-mcp -- clickup-pp-mcp。
适用场景:时间追踪聚合、冲刺报告、批量任务操作、离线分析,以及把 ClickUp 暴露给智能体。
限制:需先安装 CLI 并确保目录在 PATH;嵌套路径 group-by(如 status.status)为已知框架限制;公开 API 不返回评论正文,仅计数;--idempotent 与 --ignore-missing 需显式使用;反馈默认仅本地存储。