---

name: clickup-automation description: "通过 Rube MCP (Composio) 自动化 ClickUp 项目管理，包括任务、空间、文件夹、列表、评论和团队操作。始终先搜索工具以获取当前 Schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 ClickUp 自动化

通过 Composio 的 ClickUp 工具包自动化 ClickUp 项目管理工作流，包括任务创建和更新、工作区层级导航、评论和团队成员管理。

前提条件

• 必须连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 clickup 建立活跃的 ClickUp 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 Schema

设置

获取 Rube MCP：在你的客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥 — 只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应以验证 Rube MCP 可用
2. 使用工具包 clickup 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 ClickUp OAuth
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 创建和管理任务

适用场景：用户想要在 ClickUp 列表中创建任务、子任务、更新任务属性或列出任务。

工具调用顺序：

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - 获取工作区/团队 ID [前提]
2. CLICKUP_GET_SPACES - 列出工作区中的空间 [前提]
3. CLICKUP_GET_FOLDERS - 列出空间中的文件夹 [前提]
4. CLICKUP_GET_FOLDERLESS_LISTS - 获取不在文件夹内的列表 [可选]
5. CLICKUP_GET_LIST - 验证列表并检查可用状态 [前提]
6. CLICKUP_CREATE_TASK - 在目标列表中创建任务 [必需]
7. CLICKUP_CREATE_TASK（带 parent）- 在父任务下创建子任务 [可选]
8. CLICKUP_UPDATE_TASK - 修改任务状态、指派人、日期、优先级 [可选]
9. CLICKUP_GET_TASK - 获取完整任务详情 [可选]
10. CLICKUP_GET_TASKS - 列出列表中所有任务并支持过滤 [可选]
11. CLICKUP_DELETE_TASK - 永久删除任务 [可选]

CLICKUP_CREATE_TASK 关键参数：

• list_id：目标列表 ID（整数，必需）
• name：任务名称（字符串，必需）
• description：详细任务描述
• status：必须精确匹配（区分大小写）目标列表中配置的状态名称
• priority：1（紧急）、2（高）、3（普通）、4（低）
• assignees：用户 ID 数组（整数）
• due_date：Unix 时间戳（毫秒）
• parent：父任务 ID 字符串，用于创建子任务
• tags：标签名称字符串数组
• time_estimate：预估时间（毫秒）

注意事项：

• status 区分大小写，必须匹配列表中已有的状态；使用 CLICKUP_GET_LIST 检查可用状态
• due_date 和 start_date 是 Unix 时间戳，单位为毫秒而非秒
• 子任务的 parent 必须是同一列表中的任务（不能是另一个子任务）
• notify_all 会触发关注者通知；批量操作时设为 false
• 重试可能创建重复项；跟踪已创建的任务 ID 以避免重复创建
• 里程碑的 custom_item_id（ID 1）受工作区计划配额限制

2. 导航工作区层级

适用场景：用户想要浏览或管理 ClickUp 工作区结构（工作区 > 空间 > 文件夹 > 列表）。

工具调用顺序：

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - 列出所有可访问的工作区 [必需]
2. CLICKUP_GET_SPACES - 列出工作区内的空间 [必需]
3. CLICKUP_GET_SPACE - 获取特定空间的详情 [可选]
4. CLICKUP_GET_FOLDERS - 列出空间中的文件夹 [必需]
5. CLICKUP_GET_FOLDER - 获取特定文件夹的详情 [可选]
6. CLICKUP_CREATE_FOLDER - 在空间中创建新文件夹 [可选]
7. CLICKUP_GET_FOLDERLESS_LISTS - 列出不在任何文件夹内的列表 [必需]
8. CLICKUP_GET_LIST - 获取列表详情，包括状态和自定义字段 [可选]

关键参数：

• team_id：来自 GET_AUTHORIZED_TEAMS_WORKSPACES 的工作区 ID（获取空间时必需）
• space_id：空间 ID（获取文件夹和无文件夹列表时必需）
• folder_id：文件夹 ID（GET_FOLDER 时必需）
• list_id：列表 ID（GET_LIST 时必需）
• archived：已归档/活跃项目的布尔过滤器

注意事项：

• ClickUp 层级为：工作区（Team）> 空间 > 文件夹 > 列表 > 任务
• 列表可以直接存在于空间下（无文件夹）或在文件夹内
• 必须使用 CLICKUP_GET_FOLDERLESS_LISTS 查找不在文件夹内的列表；CLICKUP_GET_FOLDERS 只返回文件夹
• ClickUp API 中的 team_id 指的是工作区 ID，而非用户组

3. 为任务添加评论

适用场景：用户想要添加评论、查看现有评论或管理任务上的评论线程。

工具调用顺序：

1. CLICKUP_GET_TASK - 验证任务存在并获取 task_id [前提]
2. CLICKUP_CREATE_TASK_COMMENT