Monday Automation Skill for Cursor

Monday.com Automation via Rube MCP

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.

Toolkit docs: composio.dev/toolkits/monday

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Monday.com connection via RUBE_MANAGE_CONNECTIONS with toolkit monday
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

• Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
• Call RUBE_MANAGE_CONNECTIONS with toolkit monday
• If connection is not ACTIVE, follow the returned auth link to complete Monday.com OAuth
• Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Create and Manage Boards

When to use: User wants to create a new board, list existing boards, or set up workspace structure.

Tool sequence:

• MONDAY_GET_WORKSPACES - List available workspaces and resolve workspace ID [Prerequisite]
• MONDAY_LIST_BOARDS - List existing boards to check for duplicates [Optional]
• MONDAY_CREATE_BOARD - Create a new board with name, kind, and workspace [Required]
• MONDAY_CREATE_COLUMN - Add columns to the new board [Optional]
• MONDAY_CREATE_GROUP - Add groups to organize items [Optional]
• MONDAY_BOARDS - Retrieve detailed board metadata [Optional]

Key parameters:

• board_name: Name for the new board (required)
• board_kind: "public", "private", or "share" (required)
• workspace_id: Numeric workspace ID; omit for default workspace
• folder_id: Folder ID; must be within workspace_id if both provided
• template_id: ID of accessible template to clone

Pitfalls:

• board_kind is required and must be one of: "public", "private", "share"
• If both workspace_id and folder_id are provided, the folder must exist within that workspace
• template_id must reference a template the authenticated user can access
• Board IDs are large integers; always use the exact value from API responses

2. Create and Manage Items

When to use: User wants to add tasks/items to a board, list existing items, or move items between groups.

Tool sequence:

• MONDAY_LIST_BOARDS - Resolve board name to board ID [Prerequisite]
• MONDAY_LIST_GROUPS - List groups on the board to get group_id [Prerequisite]
• MONDAY_LIST_COLUMNS - Get column IDs and types for setting values [Prerequisite]
• MONDAY_CREATE_ITEM - Create a new item with name and column values [Required]
• MONDAY_LIST_BOARD_ITEMS - List all items on the board [Optional]
• MONDAY_MOVE_ITEM_TO_GROUP - Move an item to a different group [Optional]
• MONDAY_ITEMS_PAGE - Paginated item retrieval with filtering [Optional]

Key parameters:

• board_id: Board ID (required, integer)
• item_name: Item name, max 256 characters (required)
• group_id: Group ID string to place the item in (optional)
• column_values: JSON object or string mapping column IDs to values

Pitfalls:

• column_values must use column IDs (not titles); get them from MONDAY_LIST_COLUMNS
• Column value formats vary by type: status uses {"index": 0} or {"label": "Done"}, date uses {"date": "YYYY-MM-DD"}, people uses {"personsAndTeams": [{"id": 123, "kind": "person"}]}
• item_name has a 256-character maximum
• Subitem boards are NOT supported by MONDAY_CREATE_ITEM; use GraphQL via MONDAY_CREATE_OBJECT

3. Update Item Column Values

When to use: User wants to change status, date, text, or other column values on existing items.

Tool sequence:

• MONDAY_LIST_COLUMNS or MONDAY_COLUMNS - Get column IDs and types [Prerequisite]
• MONDAY_LIST_BOARD_ITEMS or MONDAY_ITEMS_PAGE - Find the target item ID [Prerequisite]
• MONDAY_CHANGE_SIMPLE_COLUMN_VALUE - Update text, status, or dropdown with a string value [Required]
• MONDAY_UPDATE_ITEM - Update complex column types (timeline, people, date) with JSON [Required]

Key parameters for MONDAY_CHANGE_SIMPLE_COLUMN_VALUE:

• board_id: Board ID (integer, required)
• item_id: Item ID (integer, required)
• column_id: Column ID string (required)
• value: Simple string value (e.g., "Done", "Working on it")
• create_labels_if_missing: true to auto-create status/dropdown labels (default true)

Key parameters for MONDAY_UPDATE_ITEM:

• board_id: Board ID (integer, required)
• item_id: Item ID (integer, required)
• column_id: Column ID string (required)
• value: JSON object matching the column type schema
• create_labels_if_missing: false by default; set true for status/dropdown

Pitfalls:

• Use MONDAY_CHANGE_SIMPLE_COLUMN_VALUE for simple text/status/dropdown updates (string value)
• Use MONDAY_UPDATE_ITEM for complex types like timeline, people, date (JSON value)
• 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")
• create_labels_if_missing defaults differ: true for CHANGE_SIMPLE, false for UPDATE_ITEM

4. Work with Groups and Board Structure

When to use: User wants to organize items into groups, add columns, or inspect board structure.

Tool sequence:

• MONDAY_LIST_BOARDS - Resolve board ID [Prerequisite]
• MONDAY_LIST_GROUPS - List all groups on a board [Required]
• MONDAY_CREATE_GROUP - Create a new group [Optional]
• MONDAY_LIST_COLUMNS or MONDAY_COLUMNS - Inspect column structure [Required]
• MONDAY_CREATE_COLUMN - Add a new column to the board [Optional]
• MONDAY_MOVE_ITEM_TO_GROUP - Reorganize items across groups [Optional]

Key parameters:

• board_id: Board ID (required for all group/column operations)
• group_name: Name for new group (CREATE_GROUP)
• column_type: Must be a valid GraphQL enum token in snake_case (e.g., "status", "text", "long_text", "numbers", "date", "dropdown", "people")
• title: Column display title
• defaults: JSON string for status/dropdown labels, e.g., '{"labels": ["To Do", "In Progress", "Done"]}'

Pitfalls:

• column_type must be exact snake_case values; "person" is NOT valid, use "people"
• Group IDs are strings (e.g., "topics", "new_group_12345"), not integers
• MONDAY_COLUMNS accepts an array of board_ids and returns column metadata including settings
• MONDAY_LIST_COLUMNS is simpler and takes a single board_id

5. Manage Subitems and Updates

When to use: User wants to view subitems of a task or add comments/updates to items.

Tool sequence:

• MONDAY_LIST_BOARD_ITEMS - Find parent item IDs [Prerequisite]
• MONDAY_LIST_SUBITEMS_BY_PARENT - Retrieve subitems with column values [Required]
• MONDAY_CREATE_UPDATE - Add a comment/update to an item [Optional]
• MONDAY_CREATE_OBJECT - Create subitems via GraphQL mutation [Optional]

Key parameters for MONDAY_LIST_SUBITEMS_BY_PARENT:

• parent_item_ids: Array of parent item IDs (integer array, required)
• include_column_values: true to include column data (default true)
• include_parent_fields: true to include parent item info (default true)

Key parameters for MONDAY_CREATE_OBJECT (GraphQL):

• query: Full GraphQL mutation string
• variables: Optional variables object

Pitfalls:

• Subitems can only be queried through their parent items
• To create subitems, use MONDAY_CREATE_OBJECT with a create_subitem GraphQL mutation
• MONDAY_CREATE_UPDATE is for adding comments/updates to items (Monday's "updates" feature), not for modifying item values
• MONDAY_CREATE_OBJECT is a raw GraphQL endpoint; ensure correct mutation syntax

Common Patterns

ID Resolution

Always resolve display names to IDs before operations:

• Board name -> board_id: MONDAY_LIST_BOARDS and match by name
• Group name -> group_id: MONDAY_LIST_GROUPS with board_id
• Column title -> column_id: MONDAY_LIST_COLUMNS with board_id
• Workspace name -> workspace_id: MONDAY_GET_WORKSPACES and match by name
• Item name -> item_id: MONDAY_LIST_BOARD_ITEMS or MONDAY_ITEMS_PAGE

Pagination

Monday.com uses cursor-based pagination for items:

• MONDAY_ITEMS_PAGE returns a cursor in the response for the next page
• Pass the cursor to the next call; board_id and query_params are ignored when cursor is provided
• Cursors are cached for 60 minutes
• Maximum limit is 500 per page
• MONDAY_LIST_BOARDS and MONDAY_GET_WORKSPACES use page-based pagination with page and limit

Column Value Formatting

Different column types require different value formats:

• Status: {"index": 0} or {"label": "Done"} or simple string "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"}

Known Pitfalls

ID Formats

• 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

Rate Limits

• Monday.com GraphQL API has complexity-based rate limits
• Large boards with many columns increase query complexity
• Use limit parameter to reduce items per request if hitting limits

Parameter Quirks

• column_type for CREATE_COLUMN must be exact snake_case enum values; "people" not "person"
• column_values in CREATE_ITEM accepts both JSON string and object formats
• MONDAY_CHANGE_SIMPLE_COLUMN_VALUE auto-creates missing labels by default; MONDAY_UPDATE_ITEM does not
• MONDAY_CREATE_OBJECT is a raw GraphQL interface; use it for operations without dedicated tools (e.g., create_subitem, delete_item, archive_board)

Response Structure

• Board items are returned as arrays with id, name, and state fields
• Column values include both raw value (JSON) and rendered text (display string)
• Subitems are nested under parent items and cannot be queried independently

Quick Reference

| Task | Tool Slug | Key Params |

|------|-----------|------------|

| List workspaces | MONDAY_GET_WORKSPACES | kind, state, limit |

| Create workspace | MONDAY_CREATE_WORKSPACE | name, kind |

| List boards | MONDAY_LIST_BOARDS | limit, page, state |

| Create board | MONDAY_CREATE_BOARD | board_name, board_kind, workspace_id |

| Get board metadata | MONDAY_BOARDS | board_ids, board_kind |

| List groups | MONDAY_LIST_GROUPS | board_id |

| Create group | MONDAY_CREATE_GROUP | board_id, group_name |

| List columns | MONDAY_LIST_COLUMNS | board_id |

| Get column metadata | MONDAY_COLUMNS | board_ids, column_types |

| Create column | MONDAY_CREATE_COLUMN | board_id, column_type, title |

| Create item | MONDAY_CREATE_ITEM | board_id, item_name, column_values |

| List board items | MONDAY_LIST_BOARD_ITEMS | board_id |

| Paginated items | MONDAY_ITEMS_PAGE | board_id, limit, query_params |

| Update column (simple) | MONDAY_CHANGE_SIMPLE_COLUMN_VALUE | board_id, item_id, column_id, value |

| Update column (complex) | MONDAY_UPDATE_ITEM | board_id, item_id, column_id, value |

| Move item to group | MONDAY_MOVE_ITEM_TO_GROUP | item_id, group_id |

| List subitems | MONDAY_LIST_SUBITEMS_BY_PARENT | parent_item_ids |

| Add comment/update | MONDAY_CREATE_UPDATE | item_id, body |

| Raw GraphQL mutation | MONDAY_CREATE_OBJECT | query, variables |

*Powered by Composio*