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

monday-automation

办公与效率

查看项目

更新于 10-15 12:11

技能介绍

用途

该技能用于自动化 Monday.com 的工作管理流程，涵盖工作区、看板、列、分组、子条目以及更新/评论线程的创建与管理，通过 Composio 的 Monday 工具集实现。

前置条件与设置

前置条件：

  • Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
  • 存在通过 RUBE_MANAGE_CONNECTIONS 激活的 Monday.com 连接，toolkit 为 monday
  • 始终先调用 RUBE_SEARCH_TOOLS 以获取当前工具 schema

设置步骤：

  1. 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥，添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS，toolkit 为 monday。
  4. 若连接不是 ACTIVE，按返回的认证链接完成 Monday.com OAuth。
  5. 在运行任何工作流前，确认连接状态显示为 ACTIVE。

主要能力（核心工作流）

1. 创建与管理看板

用于创建新看板、列出已有看板或设置工作区结构。工具顺序：MONDAY_GET_WORKSPACES 列出工作区并解析 workspace ID（前置）；MONDAY_LIST_BOARDS 列出看板以检查重复（可选）；MONDAY_CREATE_BOARD 创建看板（必需）；MONDAY_CREATE_COLUMN 添加列（可选）；MONDAY_CREATE_GROUP 添加分组（可选）；MONDAY_BOARDS 获取看板元数据（可选）。关键参数：board_name（必需）、board_kind（"public"、"private" 或 "share"，必需）、workspace_id（可选）、folder_id（若同时提供需位于该工作区内）、template_id。陷阱：board_kind 必需且取值受限；board_id 为大整数，须使用 API 返回的精确值。

2. 创建与管理条目

用于向看板添加任务/条目、列出条目或在分组间移动条目。工具顺序：MONDAY_LIST_BOARDS 解析 board ID（前置）；MONDAY_LIST_GROUPS 获取 group_id（前置）；MONDAY_LIST_COLUMNS 获取列 ID 与类型（前置）；MONDAY_CREATE_ITEM 创建条目（必需）；MONDAY_LIST_BOARD_ITEMS 列出条目（可选）；MONDAY_MOVE_ITEM_TO_GROUP 移动条目（可选）；MONDAY_ITEMS_PAGE 分页检索（可选）。关键参数：board_id（必需）、item_name（最大 256 字符）、group_id、column_values。陷阱：column_values 必须使用列 ID 而非标题；不同列类型值格式不同；子条目看板不支持 MONDAY_CREATE_ITEM，需通过 MONDAY_CREATE_OBJECT 使用 GraphQL。

3. 更新条目列值

用于更改状态、日期、文本等列值。工具顺序：MONDAY_LIST_COLUMNS 或 MONDAY_COLUMNS 获取列 ID 与类型（前置）；MONDAY_LIST_BOARD_ITEMS 或 MONDAY_ITEMS_PAGE 找到目标 item ID（前置）；MONDAY_CHANGE_SIMPLE_COLUMN_VALUE 更新简单类型（必需）；MONDAY_UPDATE_ITEM 更新复杂类型（必需）。陷阱：简单文本/状态/下拉用 CHANGE_SIMPLE_COLUMN_VALUE，复杂类型（timeline、people、date）用 UPDATE_ITEM；列 ID 为小写下划线字符串；create_labels_if_missing 默认值在两个工具中不同。

4. 分组与看板结构

用于组织条目、添加列或检查看板结构。工具顺序：MONDAY_LIST_BOARDS 解析 board ID；MONDAY_LIST_GROUPS 列出分组；MONDAY_CREATE_GROUP 创建分组（可选）；MONDAY_LIST_COLUMNS 或 MONDAY_COLUMNS 检查列结构；MONDAY_CREATE_COLUMN 添加列（可选）；MONDAY_MOVE_ITEM_TO_GROUP 重新组织条目（可选）。陷阱：column_type 必须为精确的 snake_case 枚举值（如 "people"，而非 "person"）；group ID 为字符串。

5. 子条目与更新

用于查看任务的子条目或添加评论/更新。工具顺序：MONDAY_LIST_BOARD_ITEMS 找到父条目 ID；MONDAY_LIST_SUBITEMS_BY_PARENT 检索子条目（必需）；MONDAY_CREATE_UPDATE 添加评论/更新（可选）；MONDAY_CREATE_OBJECT 通过 GraphQL mutation 创建子条目（可选）。陷阱：子条目只能通过父条目查询；创建子条目需 MONDAY_CREATE_OBJECT；MONDAY_CREATE_UPDATE 用于添加评论/更新，而非修改条目值。

通用模式

ID 解析：操作前先将显示名解析为 ID，如看板名经 MONDAY_LIST_BOARDS 匹配、分组名经 MONDAY_LIST_GROUPS、列标题经 MONDAY_LIST_COLUMNS、工作区名经 MONDAY_GET_WORKSPACES、条目名经 MONDAY_LIST_BOARD_ITEMS 或 MONDAY_ITEMS_PAGE。

分页：条目使用游标分页，MONDAY_ITEMS_PAGE 返回 cursor，提供 cursor 时忽略 board_id 和 query_params，游标缓存 60 分钟，每页最大 500。看板与工作区使用基于页的分页（page、limit）。

列值格式化：Status 用 {"index": 0} 或 {"label": "Done"} 或字符串 "Done"；Date 用 {"date": "YYYY-MM-DD"}；People 用 {"personsAndTeams": [{"id": 123, "kind": "person"}]}；Text/Numbers 用纯字符串或数字；Timeline 用 {"from": "YYYY-MM-DD", "to": "YYYY-MM-DD"}。

已知陷阱

ID 格式：看板 ID 与条目 ID 为大整数；分组 ID 为字符串；列 ID 为短字符串；工作区 ID 为整数。速率限制：Monday.com GraphQL API 有基于复杂度的速率限制，列多的看板增加查询复杂度，可用 limit 参数减少每次请求量。参数怪癖：column_type 须为精确 snake_case；column_values 接受 JSON 字符串和对象；CHANGE_SIMPLE_COLUMN_VALUE 默认自动创建缺失标签，UPDATE_ITEM 不会；MONDAY_CREATE_OBJECT 为原始 GraphQL 接口，用于无专用工具的操作。响应结构：看板条目以数组返回，含 id、name、state；列值包含原始值和渲染文本；子条目嵌套在父条目下，不能独立查询。

快速参考

工具与关键参数：MONDAY_GET_WORKSPACES（kind、state、limit）；MONDAY_CREATE_WORKSPACE（name、kind）；MONDAY_LIST_BOARDS（limit、page、state）；MONDAY_CREATE_BOARD（board_name、board_kind、workspace_id）；MONDAY_BOARDS（board_ids、board_kind）；MONDAY_LIST_GROUPS（board_id）；MONDAY_CREATE_GROUP（board_id、group_name）；MONDAY_LIST_COLUMNS（board_id）；MONDAY_COLUMNS（board_ids、column_types）；MONDAY_CREATE_COLUMN（board_id、column_type、title）；MONDAY_CREATE_ITEM（board_id、item_name、column_values）；MONDAY_LIST_BOARD_ITEMS（board_id）；MONDAY_ITEMS_PAGE（board_id、limit、query_params）；MONDAY_CHANGE_SIMPLE_COLUMN_VALUE（board_id、item_id、column_id、value）；MONDAY_UPDATE_ITEM（board_id、item_id、column_id、value）；MONDAY_MOVE_ITEM_TO_GROUP（item_id、group_id）；MONDAY_LIST_SUBITEMS_BY_PARENT（parent_item_ids）；MONDAY_CREATE_UPDATE（item_id、body）；MONDAY_CREATE_OBJECT（query、variables）。

适用场景与限制

适用场景：需要以程序化方式在 Monday.com 中进行工作管理自动化，包括看板、条目、列、分组、子条目与评论的增删改查和结构组织。限制：依赖 Rube MCP 和已激活的 Monday.com 连接；子条目看板不支持 MONDAY_CREATE_ITEM；存在基于复杂度的速率限制；部分操作需使用原始 GraphQL 接口；未提供定价、平台覆盖或效果保证等信息。