Create Table View (Platform MCP)

Creates a new table-type board view with filters, sort, tags, and table-specific settings (column visibility/order and group-by) using the Platform MCP.

Use this tool to create a new table-type board view with optional filters, sort, tags, and table-specific settings (column visibility/order and group-by). Use this instead of create_view when you need to configure table-specific settings. For a simple table view, create_view also works.

Parameters

ParameterTypeRequiredDescription
boardIdstringYesThe board ID to create the table view on.
namestringNoThe name of the view (e.g. "High Priority Items", "My Tasks").
filterobjectNoFilter configuration. Contains rules (an array of {column_id, compare_value, operator}) and an optional operator (logical operator between rules, defaults to and).
sortarrayNoSort configuration. Array of {column_id, direction} objects. direction defaults to asc.
tagsarrayNoTags to apply to the view.
settingsobjectNoTable-specific settings: columns (visibility/order) and group_by. See the settings reference below.

settings.columns fields:

FieldTypeDescription
column_propertiesarrayVisibility config for main board columns — each { column_id, visible }.
subitems_column_propertiesarrayVisibility config for subitem columns — each { column_id, visible }.
floating_columns_countnumberNumber of floating (pinned) columns to display.
column_orderarrayOrdered list of column IDs.

settings.group_by fields:

FieldTypeDescription
conditionsarrayGroup-by conditions — each { columnId, config? }, where config.sortSettings holds { direction (ASC/DESC), type? }.
hideEmptyGroupsbooleanWhether to hide groups with no items.

Filter rule operators: any_of, not_any_of, is_empty, is_not_empty, greater_than, lower_than, between, contains_text, not_contains_text (defaults to any_of).

Example

Create a table view grouped by status, with the status column pinned visible:

{
  "boardId": "1234567890",
  "name": "By Status",
  "settings": {
    "columns": {
      "column_properties": [
        { "column_id": "status", "visible": true }
      ],
      "column_order": ["name", "status", "date"]
    },
    "group_by": {
      "conditions": [{ "columnId": "status" }],
      "hideEmptyGroups": true
    }
  }
}

The tool returns a confirmation with the new table view's name, ID, and type.


Programmatic equivalent

This tool maps to the create_view_table mutation in the monday.com API. See the board views reference for full details.


Did this page help you?