clickup-automation

ClickUp Automation - 项目管理自动化技能

技能概述

ClickUp Automation 通过 Rube MCP (Composio) 实现 ClickUp 项目管理的全流程自动化，无需配置 API 密钥即可批量创建任务、管理工作区层级、添加评论和查询团队成员信息。

适用场景

1. 批量任务创建与管理

当您需要一次性创建多个 ClickUp 任务、批量更新任务状态或分配人员时，此技能可以自动遍历工作区、空间和文件夹结构，精确定位目标列表并执行批量操作，大幅提升项目管理效率。

2. 工作区自动导航

ClickUp 采用多层级结构（Workspace > Space > Folder > List > Task），手动查找特定列表或任务非常耗时。此技能提供完整的层级导航工具链，可快速定位任何位置的资源并执行操作。

3. 团队协作自动化

适用于需要自动添加任务评论、查询成员席位使用情况、或根据规则自动分配任务给团队成员的场景，帮助减少重复性的人工操作。

核心功能

任务生命周期管理

支持创建、更新、查询和删除 ClickUp 任务，包括设置优先级、分配负责人、添加截止日期、创建子任务以及按状态、标签、日期等多维度过滤任务列表。

工作区层级遍历

提供完整的工作区、空间、文件夹和列表导航功能，可获取任意层级的详细信息，支持创建新文件夹、查询无文件夹列表（folderless lists）等操作。

任务评论与团队管理

能够在任务上添加评论、获取评论历史、更新评论状态，同时支持查询工作区席位使用情况、用户组和自定义角色等团队管理功能。

常见问题

ClickUp Automation 需要什么前置条件？

您需要将 Rube MCP 服务器 (https://rube.app/mcp) 添加到客户端配置中，并通过 RUBE_MANAGE_CONNECTIONS 激活 ClickUp 工具包连接。首次使用需要完成 ClickUp OAuth 授权，之后即可直接调用所有自动化功能，无需单独管理 API 密钥。

批量创建任务时会遇到什么问题？

ClickUp 对 API 调用有速率限制，批量操作可能触发 429 响应。建议设置 notify_all=false 减少通知负载，并遵循 Retry-After 头进行重试。此外，任务状态必须与列表中配置的状态完全匹配（区分大小写），日期需使用毫秒级 Unix 时间戳。

如何获取正确的 list_id 和 task_id？

ClickUp 采用层级 ID 结构，需要按顺序解析：先通过 CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES 获取工作区 ID，再用 CLICKUP_GET_SPACES 获取空间 ID，以此类推直到获取目标列表 ID。任务 ID 则通过 CLICKUP_GET_TASKS 在指定列表中搜索任务名称来获取。注意任务 ID 是字母数字混合字符串，而工作区、空间和列表 ID 都是整数。