update_webhook
Update Webhook
Update an existing webhook's configuration such as URL, event types, enabled state, or ready column.
Ask your agent in plain language. Each of these maps to a real tool on the server.
update_webhook
Update an existing webhook's configuration such as URL, event types, enabled state, or ready column.
update_document
Update a document's properties such as name and pinned status. Can also move the document to a different workspace.
delete_document
Soft-delete a document (move to trash) or permanently delete it. Soft-deleted documents can be restored.
list_orgs
List all accessible organizations (team sites and personal spaces). Returns org IDs, names, and domains that the authenticated user can access.
add_records
Add one or more records (rows) to a table. Each record is an object of column ID to value mappings.
delete_webhook
Delete a webhook from a document. Optionally clear the pending delivery queue for a specific webhook or all webhooks.
list_webhooks
List all webhooks configured for a document, including their URLs, target tables, event types, and delivery status.
delete_records
Delete records from a table by their record IDs.
list_tables
List all tables in a Grist document. Returns table IDs and metadata.
create_table
Create one or more tables in a Grist document. Each table can be initialized with columns.
add_or_update_records
Upsert records: for each record, check if a matching record exists using the "require" fields. If found, update it with the "fields" values. If not found, create a new record combining "require" and "fields".
fetch_records
Fetch records (rows) from a table with optional filtering, sorting, and limiting. Supports filtering by column values and sorting in ascending/descending order.
create_document
Create a new empty document in a workspace.
list_columns
List all columns in a table. Returns column IDs, types, labels, and other metadata.
delete_workspace
Soft-delete a workspace (move to trash) or permanently delete it. Soft-deleted workspaces can be restored.
get_document
Retrieve details about a specific Grist document, including its name, workspace, and access information.
list_workspaces
List all workspaces in an organization, including their documents. Use the org ID from the List Organizations tool.
run_sql
Execute a read-only SQL SELECT query against a document's SQLite database. Supports parameterized queries to prevent SQL injection. Only SELECT statements are allowed.
update_records
Update existing records in a table by their record IDs. Only specified fields will be modified.
create_workspace
Create a new workspace in an organization.
modify_columns
Create, update, or delete columns in a table. Supports adding new columns with types and formulas, updating existing column properties, or removing columns.
list_attachments
List attachment metadata for a document. Returns file names, sizes, and upload times.
create_webhook
Create a webhook that sends POST requests to a URL when data changes in a document table. Supports filtering by event types (add, update) and gating with a ready column.
get_current_user
Get the identity and profile of the user who owns the connected API key.
update_workspace
Rename a workspace. Call list_workspaces to discover workspace IDs.
restore_document
Restore a document that was moved to trash. Permanently deleted documents cannot be restored.
get_workspace
Retrieve workspace details. Call list_workspaces to discover workspace IDs.
download_attachment
Download a document attachment. Call list_attachments to discover attachment IDs.
restore_workspace
Restore a workspace that was moved to trash. Permanently deleted workspaces cannot be restored.
download_document
Download a Grist document as a SQLite file, optionally removing its history or exporting its structure as a template.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Manage organizations, workspaces, documents, tables, columns, and records in Grist's relational spreadsheet-database. Create and modify tables and columns with typed fields (Text, Numeric, Date, Choice, Ref, etc.). Fetch, add, update, and delete records with filtering, sorting, and upsert support. Upload and manage file attachments. Execute read-only SQL queries against document data. Apply batch operations via user actions. Create and manage webhooks for row-added and row-updated events. Download documents as .grist or .sqlite files. Manage workspace and document access, pinning, and organization.
Common questions about connecting Grist to AI agents with Metorial.