TablesWriteDo not retry automatically

Create a table view

create_table_view

Save an arrangement of a table: its filter, sort and grouping, which fields show and how wide, footer calculations, row colour rules, and a layout (grid, board, calendar, gallery, timeline, list, form). A shared view is structure and is refused while the table is locked; a personal view belongs to the acting user and is never shown to anyone else.

Parameters

ParameterTypeRequiredDescription
tableIdstringrequiredTable ID
namestringrequiredView name, unique per table
scope"shared" | "personal"optionalshared (default) is visible to the whole workspace; personal is the acting user’s alone
duplicateOfstringoptionalCopy everything but the name from this view, its layout included
iconstringoptionalIcon catalog id (e.g. emoji:pin); omit for the layout default
queryobjectoptionalWhich rows, in what order, grouped how: { filter, sort: [{ field, direction }], group: [{ field }] }. filter is the same tree query_table_rows takes, or null.
fieldsobjectoptionalField arrangement by key: { order, hidden, widths, pins: { left, right }, wrap }
calculationsobjectoptionalFooter calculation per field key, e.g. { amount: "sum" }
decorationsobject | object[]optionalRow colour rules: [{ id, condition, color, style? }]; the first match wins
density"comfortable" | "compact" | "tight"optionalInput for density.
layoutunknownoptionalLayout: { layout: "grid" }, { layout: "board", groupField }, { layout: "calendar", dateField }, { layout: "gallery" }, { layout: "timeline", startField }, { layout: "list" } or { layout: "form" }. A board groups by a select, status, single user or one-row relation field.

Example call

The tool call an MCP client sends (required arguments shown with placeholder values).

{
"tool": "create_table_view",
"arguments": {
"tableId": "tableId_123",
"name": "value"
}
}

Use this tool in

Related Tables tools