MCP & AI Agent Integration

Grist
automation.

13 AI agent actions for Grist — callable from any MCP-compatible runtime, Claude, Cursor, or Cerebral OS workflow. Use Grist to organize files, generate documents, and manage permissions programmatically. Full governance, audit trail, and dry-run safety on every execution.

No credit card required
Live in production environments
<200ms median execution
Dry-run before production
Execution trace
live
13
actions
100%
governed
<200ms
latency
13
AI agent actions
7
Read operations
6
Write operations
1
High-risk actions (approval gated)
Files & Documents Grist is a Files & Documents integration — use it to automate file storage, sharing, and document management from any AI agent or MCP-compatible runtime.
Actions

What you can do
with Grist.

Every action below is available as an MCP tool and a verb in Cerebral OS — callable from any AI agent, Claude, Cursor, Windsurf, or your own runtime via the BYOA API. All executions are governed, audited, and dry-run safe.

Get Document
grist:get_document
Fetch a single document's metadata and basic information.
Read Low risk
Get Record
grist:get_record
Fetch a single record by ID from a table.
Read Low risk
Get Table
grist:get_table
Fetch table metadata including column information and structure.
Read Low risk
List Documents
grist:list_documents
List all documents accessible to the API key, optionally filtered by workspace.
Read Low risk
List Records
grist:list_records
List records from a table with optional filtering and sorting.
Read Low risk
List Tables
grist:list_tables
List all tables in a document with their basic metadata.
Read Low risk
Search Records
grist:search_records
Search for records containing the query text across specified or all columns.
Read Low risk
Add Column
grist:add_column
Add a new column to a table with specified type and optional formula.
Write Medium risk
Create Record
grist:create_record
Create a new record in a table with the specified field values.
Write Medium risk
Create Records Bulk
grist:create_records_bulk
Create multiple records in a table in a single API call.
Write Medium risk
Delete Record
grist:delete_record
Delete a record from a table. This action cannot be undone.
Write High risk
Update Record
grist:update_record
Update an existing record with new field values.
Write Medium risk
Update Records Bulk
grist:update_records_bulk
Update multiple records in a table in a single API call.
Write Medium risk
MCP & Runtime API

Call Grist
from any AI agent.

Any AI agent — Claude, Cursor, LangChain, AutoGen, or your own — can call Grist actions through the Cerebral OS Runtime API. Governance, credentials, and audit trail fire automatically.

grist:get_document READ
# Call via Runtime API
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "grist:get_document",
    "args": {},
    "execution_id": "agent-001"
  }'
grist:add_column WRITE
# Dry-run first — no production risk
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "grist:add_column",
    "args": {},
    "execution_id": "agent-001",
    "metadata": {"dryRun": true}
  }'
Get your Runtime API key at app.cerebralos.com/signup — 1,000 free executions, no credit card required.
AI agent examples

What your AI agent
can do with Grist.

Real patterns your AI agent can execute via MCP or the Runtime API. Every action governed, dry-run safe, and fully audited.

Trigger
AI agent needs Grist data
Call grist:get_document via MCP or Runtime API
AI processes result and takes next action
Full execution logged to audit trail automatically
Trigger
Workflow needs to write to Grist
Dry-run validates grist:add_column before execution
Approval gate fires if risk level is high
Action executes with full governance — logged, audited, reversible
Trigger
File or document event
Process with AI
Route for approval
Notify team
How it works

Every Grist action
governed end-to-end.

Cerebral OS isn't a connector. It's the execution layer that sits in front of Grist — adding governance, dry-run safety, and a full audit trail to every operation.

Governance first
Every verb carries a risk classification. High-risk writes require explicit approval gates before they execute in production.
Dry-run safe
Simulate any Grist action before it touches production. See exactly what would happen before a single real call is made.
Immutable audit trail
Every Grist action is logged — what ran, what changed, who approved it, when it happened. Full history on every verb, forever.
Connect with

Grist works best
alongside these.

Build multi-step workflows that connect Grist to the rest of your stack. All governed. All audited.

Grist integration

Start free.
No credit card required.

Start free with 1,000 runs — no credit card required. Connect Grist in minutes, dry-run every action before it touches production, full audit trail on everything.

Start free — 1,000 runs Browse all integrations →