TablesWriteDo not retry automatically
Create a table view
create_table_viewSave 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
| Parameter | Type | Required | Description |
|---|---|---|---|
tableId | string | required | Table ID |
name | string | required | View name, unique per table |
scope | "shared" | "personal" | optional | shared (default) is visible to the whole workspace; personal is the acting user’s alone |
duplicateOf | string | optional | Copy everything but the name from this view, its layout included |
icon | string | optional | Icon catalog id (e.g. emoji:pin); omit for the layout default |
query | object | optional | Which rows, in what order, grouped how: { filter, sort: [{ field, direction }], group: [{ field }] }. filter is the same tree query_table_rows takes, or null. |
fields | object | optional | Field arrangement by key: { order, hidden, widths, pins: { left, right }, wrap } |
calculations | object | optional | Footer calculation per field key, e.g. { amount: "sum" } |
decorations | object | object[] | optional | Row colour rules: [{ id, condition, color, style? }]; the first match wins |
density | "comfortable" | "compact" | "tight" | optional | Input for density. |
layout | unknown | optional | Layout: { 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
Claude CodeClaude DesktopClaude CoworkChatGPTCursorWindsurfVS Code CopilotOpenClawGeminiHermes Agent
Related Tables tools
List tables
list_tablesList the tables in the workspace (id, name, kind — typed or custom — resource type, fields, row count, schema/revision versions).Get tableget_tableGet one table by id: its full field set (key, label, kind, display format, select options, whether the field is feed-owned and whether it can be written), the fields that form row identity, the promoted primary/date/amount bindings, row count, and its schema badge.Create tablecreate_tableCreate a table in the workspace.Update tableupdate_tableUpdate a table’s METADATA — name, icon, retention policy.