monday-automation
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseMonday.com Automation via Rube MCP
通过Rube MCP实现Monday.com自动化
Automate Monday.com work management workflows including board creation, item management, column value updates, group organization, subitems, and update/comment threads through Composio's Monday toolkit.
通过Composio的Monday工具包,自动化Monday.com的工作管理工作流,包括看板创建、事项管理、列值更新、分组组织、子事项以及更新/评论线程。
Prerequisites
前提条件
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Monday.com connection via with toolkit
RUBE_MANAGE_CONNECTIONSmonday - Always call first to get current tool schemas
RUBE_SEARCH_TOOLS
- 必须已连接Rube MCP(需提供RUBE_SEARCH_TOOLS)
- 通过并使用工具包
RUBE_MANAGE_CONNECTIONS完成Monday.com的激活连接monday - 请始终先调用以获取当前的工具架构
RUBE_SEARCH_TOOLS
Setup
设置步骤
Get Rube MCP: Add as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
https://rube.app/mcp- Verify Rube MCP is available by confirming responds
RUBE_SEARCH_TOOLS - Call with toolkit
RUBE_MANAGE_CONNECTIONSmonday - If connection is not ACTIVE, follow the returned auth link to complete Monday.com OAuth
- Confirm connection status shows ACTIVE before running any workflows
获取Rube MCP:在客户端配置中添加作为MCP服务器。无需API密钥 —— 只需添加端点即可使用。
https://rube.app/mcp- 通过确认能正常响应,验证Rube MCP是否可用
RUBE_SEARCH_TOOLS - 调用并指定工具包
RUBE_MANAGE_CONNECTIONSmonday - 如果连接未处于ACTIVE状态,请按照返回的授权链接完成Monday.com的OAuth认证
- 在运行任何工作流之前,确认连接状态显示为ACTIVE
Core Workflows
核心工作流
1. Create and Manage Boards
1. 创建与管理看板
When to use: User wants to create a new board, list existing boards, or set up workspace structure.
Tool sequence:
- - List available workspaces and resolve workspace ID [Prerequisite]
MONDAY_GET_WORKSPACES - - List existing boards to check for duplicates [Optional]
MONDAY_LIST_BOARDS - - Create a new board with name, kind, and workspace [Required]
MONDAY_CREATE_BOARD - - Add columns to the new board [Optional]
MONDAY_CREATE_COLUMN - - Add groups to organize items [Optional]
MONDAY_CREATE_GROUP - - Retrieve detailed board metadata [Optional]
MONDAY_BOARDS
Key parameters:
- : Name for the new board (required)
board_name - : "public", "private", or "share" (required)
board_kind - : Numeric workspace ID; omit for default workspace
workspace_id - : Folder ID; must be within
folder_idif both providedworkspace_id - : ID of accessible template to clone
template_id
Pitfalls:
- is required and must be one of: "public", "private", "share"
board_kind - If both and
workspace_idare provided, the folder must exist within that workspacefolder_id - must reference a template the authenticated user can access
template_id - Board IDs are large integers; always use the exact value from API responses
适用场景:用户想要创建新看板、列出现有看板,或设置工作区结构。
工具执行顺序:
- - 列出可用工作区并解析工作区ID [前提步骤]
MONDAY_GET_WORKSPACES - - 列出现有看板以检查是否存在重复项 [可选]
MONDAY_LIST_BOARDS - - 创建包含名称、类型和所属工作区的新看板 [必需]
MONDAY_CREATE_BOARD - - 为新看板添加列 [可选]
MONDAY_CREATE_COLUMN - - 添加分组以组织事项 [可选]
MONDAY_CREATE_GROUP - - 获取详细的看板元数据 [可选]
MONDAY_BOARDS
关键参数:
- : 新看板的名称(必填)
board_name - : "public"、"private"或"share"(必填)
board_kind - : 数字格式的工作区ID;使用默认工作区时可省略
workspace_id - : 文件夹ID;如果同时提供
folder_id,则该文件夹必须属于指定工作区workspace_id - : 可访问的模板ID,用于克隆看板
template_id
注意事项:
- 为必填项,且必须是以下值之一:"public"、"private"或"share"
board_kind - 如果同时提供和
workspace_id,文件夹必须存在于该工作区内folder_id - 必须指向已认证用户可访问的模板
template_id - 看板ID为大整数;请始终使用API响应中的精确值
2. Create and Manage Items
2. 创建与管理事项
When to use: User wants to add tasks/items to a board, list existing items, or move items between groups.
Tool sequence:
- - Resolve board name to board ID [Prerequisite]
MONDAY_LIST_BOARDS - - List groups on the board to get group_id [Prerequisite]
MONDAY_LIST_GROUPS - - Get column IDs and types for setting values [Prerequisite]
MONDAY_LIST_COLUMNS - - Create a new item with name and column values [Required]
MONDAY_CREATE_ITEM - - List all items on the board [Optional]
MONDAY_LIST_BOARD_ITEMS - - Move an item to a different group [Optional]
MONDAY_MOVE_ITEM_TO_GROUP - - Paginated item retrieval with filtering [Optional]
MONDAY_ITEMS_PAGE
Key parameters:
- : Board ID (required, integer)
board_id - : Item name, max 256 characters (required)
item_name - : Group ID string to place the item in (optional)
group_id - : JSON object or string mapping column IDs to values
column_values
Pitfalls:
- must use column IDs (not titles); get them from
column_valuesMONDAY_LIST_COLUMNS - Column value formats vary by type: status uses or
{"index": 0}, date uses{"label": "Done"}, people uses{"date": "YYYY-MM-DD"}{"personsAndTeams": [{"id": 123, "kind": "person"}]} - has a 256-character maximum
item_name - Subitem boards are NOT supported by ; use GraphQL via
MONDAY_CREATE_ITEMMONDAY_CREATE_OBJECT
适用场景:用户想要向看板添加任务/事项、列出现有事项,或在分组间移动事项。
工具执行顺序:
- - 将看板名称解析为看板ID [前提步骤]
MONDAY_LIST_BOARDS - - 列出看板中的分组以获取group_id [前提步骤]
MONDAY_LIST_GROUPS - - 获取列ID和类型以设置值 [前提步骤]
MONDAY_LIST_COLUMNS - - 创建包含名称和列值的新事项 [必需]
MONDAY_CREATE_ITEM - - 列出看板中的所有事项 [可选]
MONDAY_LIST_BOARD_ITEMS - - 将事项移动到其他分组 [可选]
MONDAY_MOVE_ITEM_TO_GROUP - - 分页获取事项并支持过滤 [可选]
MONDAY_ITEMS_PAGE
关键参数:
- : 看板ID(必填,整数类型)
board_id - : 事项名称,最大长度256字符(必填)
item_name - : 放置事项的分组ID字符串(可选)
group_id - : 映射列ID到值的JSON对象或字符串
column_values
注意事项:
- 必须使用列ID(而非标题);可通过
column_values获取MONDAY_LIST_COLUMNS - 列值格式因类型而异:状态列使用或
{"index": 0},日期列使用{"label": "Done"},人员列使用{"date": "YYYY-MM-DD"}{"personsAndTeams": [{"id": 123, "kind": "person"}]} - 的最大长度为256字符
item_name - 不支持子事项看板;请通过
MONDAY_CREATE_ITEM使用GraphQLMONDAY_CREATE_OBJECT
3. Update Item Column Values
3. 更新事项列值
When to use: User wants to change status, date, text, or other column values on existing items.
Tool sequence:
- or
MONDAY_LIST_COLUMNS- Get column IDs and types [Prerequisite]MONDAY_COLUMNS - or
MONDAY_LIST_BOARD_ITEMS- Find the target item ID [Prerequisite]MONDAY_ITEMS_PAGE - - Update text, status, or dropdown with a string value [Required]
MONDAY_CHANGE_SIMPLE_COLUMN_VALUE - - Update complex column types (timeline, people, date) with JSON [Required]
MONDAY_UPDATE_ITEM
Key parameters for MONDAY_CHANGE_SIMPLE_COLUMN_VALUE:
- : Board ID (integer, required)
board_id - : Item ID (integer, required)
item_id - : Column ID string (required)
column_id - : Simple string value (e.g., "Done", "Working on it")
value - : true to auto-create status/dropdown labels (default true)
create_labels_if_missing
Key parameters for MONDAY_UPDATE_ITEM:
- : Board ID (integer, required)
board_id - : Item ID (integer, required)
item_id - : Column ID string (required)
column_id - : JSON object matching the column type schema
value - : false by default; set true for status/dropdown
create_labels_if_missing
Pitfalls:
- Use for simple text/status/dropdown updates (string value)
MONDAY_CHANGE_SIMPLE_COLUMN_VALUE - Use for complex types like timeline, people, date (JSON value)
MONDAY_UPDATE_ITEM - Column IDs are lowercase strings with underscores (e.g., "status_1", "date_2", "text"); get them from
MONDAY_LIST_COLUMNS - Status values can be set by label name ("Done") or index number ("1")
- defaults differ: true for CHANGE_SIMPLE, false for UPDATE_ITEM
create_labels_if_missing
适用场景:用户想要修改现有事项的状态、日期、文本或其他列值。
工具执行顺序:
- 或
MONDAY_LIST_COLUMNS- 获取列ID和类型 [前提步骤]MONDAY_COLUMNS - 或
MONDAY_LIST_BOARD_ITEMS- 找到目标事项ID [前提步骤]MONDAY_ITEMS_PAGE - - 使用字符串值更新文本、状态或下拉列表 [必需]
MONDAY_CHANGE_SIMPLE_COLUMN_VALUE - - 使用JSON更新复杂列类型(时间线、人员、日期) [必需]
MONDAY_UPDATE_ITEM
MONDAY_CHANGE_SIMPLE_COLUMN_VALUE的关键参数:
- : 看板ID(整数,必填)
board_id - : 事项ID(整数,必填)
item_id - : 列ID字符串(必填)
column_id - : 简单字符串值(例如:"Done"、"Working on it")
value - : 若缺失则自动创建状态/下拉标签(默认值为true)
create_labels_if_missing
MONDAY_UPDATE_ITEM的关键参数:
- : 看板ID(整数,必填)
board_id - : 事项ID(整数,必填)
item_id - : 列ID字符串(必填)
column_id - : 匹配列类型架构的JSON对象
value - : 默认值为false;针对状态/下拉列可设置为true
create_labels_if_missing
注意事项:
- 对于简单的文本/状态/下拉列表更新(字符串值),使用
MONDAY_CHANGE_SIMPLE_COLUMN_VALUE - 对于复杂类型(如时间线、人员、日期),使用(JSON值)
MONDAY_UPDATE_ITEM - 列ID为带下划线的小写字符串(例如:"status_1"、"date_2"、"text");可通过获取
MONDAY_LIST_COLUMNS - 状态值可通过标签名称("Done")或索引编号("1")设置
- 的默认值不同:CHANGE_SIMPLE为true,UPDATE_ITEM为false
create_labels_if_missing
4. Work with Groups and Board Structure
4. 分组与看板结构管理
When to use: User wants to organize items into groups, add columns, or inspect board structure.
Tool sequence:
- - Resolve board ID [Prerequisite]
MONDAY_LIST_BOARDS - - List all groups on a board [Required]
MONDAY_LIST_GROUPS - - Create a new group [Optional]
MONDAY_CREATE_GROUP - or
MONDAY_LIST_COLUMNS- Inspect column structure [Required]MONDAY_COLUMNS - - Add a new column to the board [Optional]
MONDAY_CREATE_COLUMN - - Reorganize items across groups [Optional]
MONDAY_MOVE_ITEM_TO_GROUP
Key parameters:
- : Board ID (required for all group/column operations)
board_id - : Name for new group (CREATE_GROUP)
group_name - : Must be a valid GraphQL enum token in snake_case (e.g., "status", "text", "long_text", "numbers", "date", "dropdown", "people")
column_type - : Column display title
title - : JSON string for status/dropdown labels, e.g.,
defaults'{"labels": ["To Do", "In Progress", "Done"]}'
Pitfalls:
- must be exact snake_case values; "person" is NOT valid, use "people"
column_type - Group IDs are strings (e.g., "topics", "new_group_12345"), not integers
- accepts an array of
MONDAY_COLUMNSand returns column metadata including settingsboard_ids - is simpler and takes a single
MONDAY_LIST_COLUMNSboard_id
适用场景:用户想要将事项组织成分组、添加列,或查看看板结构。
工具执行顺序:
- - 解析看板ID [前提步骤]
MONDAY_LIST_BOARDS - - 列出看板中的所有分组 [必需]
MONDAY_LIST_GROUPS - - 创建新分组 [可选]
MONDAY_CREATE_GROUP - 或
MONDAY_LIST_COLUMNS- 查看列结构 [必需]MONDAY_COLUMNS - - 向看板添加新列 [可选]
MONDAY_CREATE_COLUMN - - 在分组间重新组织事项 [可选]
MONDAY_MOVE_ITEM_TO_GROUP
关键参数:
- : 看板ID(所有分组/列操作的必填项)
board_id - : 新分组的名称(CREATE_GROUP)
group_name - : 必须为有效的GraphQL枚举值(蛇形命名法),例如:"status"、"text"、"long_text"、"numbers"、"date"、"dropdown"、"people"
column_type - : 列的显示标题
title - : 状态/下拉标签的JSON字符串,例如:
defaults'{"labels": ["To Do", "In Progress", "Done"]}'
注意事项:
- 必须为精确的蛇形命名法值;"person"无效,请使用"people"
column_type - 分组ID为字符串(例如:"topics"、"new_group_12345"),而非整数
- 接受
MONDAY_COLUMNS数组,并返回包含设置信息的列元数据board_ids - 更简单,仅需单个
MONDAY_LIST_COLUMNSboard_id
5. Manage Subitems and Updates
5. 子事项与更新管理
When to use: User wants to view subitems of a task or add comments/updates to items.
Tool sequence:
- - Find parent item IDs [Prerequisite]
MONDAY_LIST_BOARD_ITEMS - - Retrieve subitems with column values [Required]
MONDAY_LIST_SUBITEMS_BY_PARENT - - Add a comment/update to an item [Optional]
MONDAY_CREATE_UPDATE - - Create subitems via GraphQL mutation [Optional]
MONDAY_CREATE_OBJECT
Key parameters for MONDAY_LIST_SUBITEMS_BY_PARENT:
- : Array of parent item IDs (integer array, required)
parent_item_ids - : true to include column data (default true)
include_column_values - : true to include parent item info (default true)
include_parent_fields
Key parameters for MONDAY_CREATE_OBJECT (GraphQL):
- : Full GraphQL mutation string
query - : Optional variables object
variables
Pitfalls:
- Subitems can only be queried through their parent items
- To create subitems, use with a
MONDAY_CREATE_OBJECTGraphQL mutationcreate_subitem - is for adding comments/updates to items (Monday's "updates" feature), not for modifying item values
MONDAY_CREATE_UPDATE - is a raw GraphQL endpoint; ensure correct mutation syntax
MONDAY_CREATE_OBJECT
适用场景:用户想要查看任务的子事项,或为事项添加评论/更新。
工具执行顺序:
- - 找到父事项ID [前提步骤]
MONDAY_LIST_BOARD_ITEMS - - 获取包含列值的子事项 [必需]
MONDAY_LIST_SUBITEMS_BY_PARENT - - 为事项添加评论/更新 [可选]
MONDAY_CREATE_UPDATE - - 通过GraphQL mutation创建子事项 [可选]
MONDAY_CREATE_OBJECT
MONDAY_LIST_SUBITEMS_BY_PARENT的关键参数:
- : 父事项ID数组(整数数组,必填)
parent_item_ids - : 是否包含列数据(默认值为true)
include_column_values - : 是否包含父事项信息(默认值为true)
include_parent_fields
MONDAY_CREATE_OBJECT(GraphQL)的关键参数:
- : 完整的GraphQL mutation字符串
query - : 可选的变量对象
variables
注意事项:
- 只能通过父事项查询子事项
- 若要创建子事项,请使用并调用
MONDAY_CREATE_OBJECTGraphQL mutationcreate_subitem - 用于为事项添加评论/更新(Monday的“更新”功能),而非修改事项值
MONDAY_CREATE_UPDATE - 是原生GraphQL端点;请确保mutation语法正确
MONDAY_CREATE_OBJECT
Common Patterns
常见模式
ID Resolution
ID解析
Always resolve display names to IDs before operations:
- Board name -> board_id: and match by name
MONDAY_LIST_BOARDS - Group name -> group_id: with
MONDAY_LIST_GROUPSboard_id - Column title -> column_id: with
MONDAY_LIST_COLUMNSboard_id - Workspace name -> workspace_id: and match by name
MONDAY_GET_WORKSPACES - Item name -> item_id: or
MONDAY_LIST_BOARD_ITEMSMONDAY_ITEMS_PAGE
在执行操作前,请始终将显示名称解析为ID:
- 看板名称 -> board_id: 使用并按名称匹配
MONDAY_LIST_BOARDS - 分组名称 -> group_id: 使用带的
board_idMONDAY_LIST_GROUPS - 列标题 -> column_id: 使用带的
board_idMONDAY_LIST_COLUMNS - 工作区名称 -> workspace_id: 使用并按名称匹配
MONDAY_GET_WORKSPACES - 事项名称 -> item_id: 使用或
MONDAY_LIST_BOARD_ITEMSMONDAY_ITEMS_PAGE
Pagination
分页
Monday.com uses cursor-based pagination for items:
- returns a
MONDAY_ITEMS_PAGEin the response for the next pagecursor - Pass the to the next call;
cursorandboard_idare ignored when cursor is providedquery_params - Cursors are cached for 60 minutes
- Maximum is 500 per page
limit - and
MONDAY_LIST_BOARDSuse page-based pagination withMONDAY_GET_WORKSPACESandpagelimit
Monday.com对事项使用基于游标(cursor)的分页:
- 的响应中会返回下一页的
MONDAY_ITEMS_PAGEcursor - 将传递给下一次调用;当提供cursor时,
cursor和board_id会被忽略query_params - 游标的缓存时间为60分钟
- 每页最大为500
limit - 和
MONDAY_LIST_BOARDS使用基于页码的分页,参数为MONDAY_GET_WORKSPACES和pagelimit
Column Value Formatting
列值格式
Different column types require different value formats:
- Status: or
{"index": 0}or simple string "Done"{"label": "Done"} - Date:
{"date": "YYYY-MM-DD"} - People:
{"personsAndTeams": [{"id": 123, "kind": "person"}]} - Text/Numbers: Plain string or number
- Timeline:
{"from": "YYYY-MM-DD", "to": "YYYY-MM-DD"}
不同列类型需要不同的值格式:
- 状态: 或
{"index": 0}或简单字符串"Done"{"label": "Done"} - 日期:
{"date": "YYYY-MM-DD"} - 人员:
{"personsAndTeams": [{"id": 123, "kind": "person"}]} - 文本/数字: 纯字符串或数字
- 时间线:
{"from": "YYYY-MM-DD", "to": "YYYY-MM-DD"}
Known Pitfalls
常见注意事项
ID Formats
ID格式
- Board IDs and item IDs are large integers (e.g., 1234567890)
- Group IDs are strings (e.g., "topics", "new_group_12345")
- Column IDs are short strings (e.g., "status_1", "date4", "text")
- Workspace IDs are integers
- 看板ID和事项ID为大整数(例如:1234567890)
- 分组ID为字符串(例如:"topics"、"new_group_12345")
- 列ID为短字符串(例如:"status_1"、"date4"、"text")
- 工作区ID为整数
Rate Limits
速率限制
- Monday.com GraphQL API has complexity-based rate limits
- Large boards with many columns increase query complexity
- Use parameter to reduce items per request if hitting limits
limit
- Monday.com GraphQL API基于复杂度设置速率限制
- 包含大量列的大看板会增加查询复杂度
- 如果达到限制,请使用参数减少每次请求的事项数量
limit
Parameter Quirks
参数细节
- for CREATE_COLUMN must be exact snake_case enum values; "people" not "person"
column_type - in CREATE_ITEM accepts both JSON string and object formats
column_values - auto-creates missing labels by default;
MONDAY_CHANGE_SIMPLE_COLUMN_VALUEdoes notMONDAY_UPDATE_ITEM - is a raw GraphQL interface; use it for operations without dedicated tools (e.g., create_subitem, delete_item, archive_board)
MONDAY_CREATE_OBJECT
- CREATE_COLUMN的必须为精确的蛇形命名法枚举值;使用"people"而非"person"
column_type - CREATE_ITEM中的接受JSON字符串和对象两种格式
column_values - 默认自动创建缺失的标签;
MONDAY_CHANGE_SIMPLE_COLUMN_VALUE则不会MONDAY_UPDATE_ITEM - 是原生GraphQL接口;请将其用于无专用工具的操作(例如:create_subitem、delete_item、archive_board)
MONDAY_CREATE_OBJECT
Response Structure
响应结构
- Board items are returned as arrays with ,
id, andnamefieldsstate - Column values include both raw (JSON) and rendered
value(display string)text - Subitems are nested under parent items and cannot be queried independently
- 看板事项以数组形式返回,包含、
id和name字段state - 列值包含原始(JSON)和渲染后的
value(显示字符串)text - 子事项嵌套在父事项下,无法独立查询
Quick Reference
快速参考
| Task | Tool Slug | Key Params |
|---|---|---|
| List workspaces | | |
| Create workspace | | |
| List boards | | |
| Create board | | |
| Get board metadata | | |
| List groups | | |
| Create group | | |
| List columns | | |
| Get column metadata | | |
| Create column | | |
| Create item | | |
| List board items | | |
| Paginated items | | |
| Update column (simple) | | |
| Update column (complex) | | |
| Move item to group | | |
| List subitems | | |
| Add comment/update | | |
| Raw GraphQL mutation | | |
| 任务 | 工具标识 | 关键参数 |
|---|---|---|
| 列出工作区 | | |
| 创建工作区 | | |
| 列出看板 | | |
| 创建看板 | | |
| 获取看板元数据 | | |
| 列出分组 | | |
| 创建分组 | | |
| 列出列 | | |
| 获取列元数据 | | |
| 创建列 | | |
| 创建事项 | | |
| 列出看板事项 | | |
| 分页获取事项 | | |
| 更新列(简单) | | |
| 更新列(复杂) | | |
| 移动事项到分组 | | |
| 列出子事项 | | |
| 添加评论/更新 | | |
| 原生GraphQL mutation | | |