SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场clickup-automation

clickup-automation

办公与效率

查看项目

更新于 10-15 11:59

技能介绍

ClickUp Automation 是通过 Rube MCP（基于 Composio 的 ClickUp 工具包）来自动化 ClickUp 项目管理流程的技能，覆盖任务创建与更新、工作区层级导航、评论以及团队成员管理等操作。

一、用途 该技能用于把 ClickUp 中的常见项目管理动作自动化，包括：

  • 创建和更新任务、子任务，修改任务属性和列出任务；
  • 浏览和管理工作区结构（工作区 > 空间 > 文件夹 > 列表）；
  • 在任务上添加、查看和更新评论；
  • 查看工作区成员、座位使用情况，以及用户与用户组信息；
  • 按条件筛选和查询任务。

二、前提条件

  • 必须已连接 Rube MCP（可获得 RUBE_SEARCH_TOOLS）。
  • 必须通过 RUBE_MANAGE_CONNECTIONS 建立有效的 ClickUp 连接，toolkit 为 clickup。
  • 始终先调用 RUBE_SEARCH_TOOLS 以获取当前工具 schema。

三、安装与设置

  • 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥，添加端点即可工作。
  • 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
  • 调用 RUBE_MANAGE_CONNECTIONS，toolkit 使用 clickup。
  • 如果连接状态不是 ACTIVE，按返回的授权链接完成 ClickUp OAuth。
  • 确认连接状态显示为 ACTIVE 后再运行任何工作流。

四、核心工作流

  1. 创建与管理任务：获取工作区/团队 ID、空间、文件夹、无文件夹列表，校验列表并检查可用状态，然后创建任务；可选创建子任务、更新任务状态/负责人/日期/优先级、获取任务详情、列出任务、删除任务。CLICKUP_CREATE_TASK 的关键参数包括 list_id（整数，必填）、name（字符串，必填）、description、status（必须与目标列表配置的状态名完全一致且区分大小写）、priority（1 紧急、2 高、3 普通、4 低）、assignees（用户 ID 整数数组）、due_date（毫秒级 Unix 时间戳）、parent（用于创建子任务的父任务 ID 字符串）、tags、time_estimate（毫秒）。
  2. 导航工作区层级：列出可访问工作区、空间、文件夹、无文件夹列表，并可获取空间/文件夹/列表详情、创建文件夹。ClickUp 层级为：工作区（团队）> 空间 > 文件夹 > 列表 > 任务；列表可以直接位于空间下（无文件夹），也可位于文件夹内。
  3. 添加任务评论：先获取任务确认存在并拿到 task_id，再创建评论；可列出已有评论、更新评论。CLICKUP_CREATE_TASK_COMMENT 需 task_id、comment_text、assignee、notify_all 四个字段。
  4. 管理团队成员与分配：列出工作区并获取 team_id，查看座位使用情况，列出用户组，获取用户详情（仅企业版），列出自定义角色。
  5. 筛选与查询任务：使用 CLICKUP_GET_TASKS 按状态、负责人、标签、日期范围、是否包含已关闭任务、是否包含子任务等条件筛选，并可按 id、created、updated、due_date 排序、分页。

五、常见模式

  • ID 解析：始终按层级把名称解析为 ID：工作区名 -> team_id；空间名 -> space_id；文件夹名 -> folder_id；列表名 -> list_id；任务名 -> task_id。
  • 分页：CLICKUP_GET_TASKS 基于页码（从 0 开始，每页最多 100 条）；CLICKUP_GET_TASK_COMMENTS 使用 start（毫秒级 Unix 时间戳）和 start_id 做游标分页，每页最多 25 条；持续拉取直到返回数量少于页大小。

六、已知注意事项

  • ID 格式：工作区/团队 ID 为大整数；空间、文件夹、列表 ID 为整数；任务 ID 为字母数字字符串（如 "9hz"、"abc123"）；用户 ID 为整数；评论 ID 为整数。
  • 限流：ClickUp 存在限流，批量创建任务可能触发 429；有 Retry-After 头时应遵循；批量操作设置 notify_all=false 以减少通知负载。
  • 参数细节：team_id 在 API 中含义是工作区 ID，不是用户组；任务 status 区分大小写且与列表相关；日期为毫秒级 Unix 时间戳（秒数乘以 1000）；priority 为 1-4 的整数而非字符串；清空任务描述时向 CLICKUP_UPDATE_TASK 传单个空格 " "。
  • 层级规则：子任务的父任务本身不能是子任务；子任务父任务必须在同一列表；子项看板不被 CLICKUP_CREATE_TASK 支持。
  • 其他：status 区分大小写且必须匹配列表中已有状态，可用 CLICKUP_GET_LIST 检查；due_date 和 start_date 为毫秒级 Unix 时间戳；notify_all 会触发关注者通知；重试可能创建重复任务，需跟踪已创建的任务 ID；custom_item_id 用于里程碑（ID 1）时受工作区套餐配额限制；statuses 字符串需精确匹配，空格用 URL 编码（如 "to%20do"）；custom_fields 过滤器接受 JSON 字符串数组而非对象。