Connect Grist to Your AI Agent

Point AI to a document and table to analyze records using their actual column definitions.

8 tools API key

Try a Grist Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Grist

Summarize filtered table records

Inspect columns and summarize records matching your chosen values.

/oo Grist: For Grist document [ID], table [ID], inspect columns and read rows matching [criteria]. Summarize totals and exceptions, preserving row IDs.

Start Working with Grist

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Grist

    Connect a Grist Cloud API key from Profile Settings → API.

    Connect Grist →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A Grist Cloud API key with document access.

Grist Tools

The Grist Cloud connection reads workspaces, documents, tables, columns, and records and can add, update, or delete table rows.

Table data

Discover tables and columns, read filtered rows, and add or update records by row ID.

8 tools

List Workspaces

List the Grist workspaces and documents that the authenticated API key can access on the current Grist site.

grist.list_workspaces

Get Document

Fetch metadata for a Grist document by document ID or short URL alias.

grist.get_document

List Tables

List the tables defined in a Grist document.

grist.list_tables

List Columns

List the columns defined in a Grist table.

grist.list_columns

List Records

List records from a Grist table with optional filtering, sorting, limits, and hidden-column inclusion.

grist.list_records

Add Records

Add one or more records to a Grist table.

grist.add_records

Update Records

Update one or more existing Grist records by row ID.

grist.update_records

Delete Records

Delete one or more records from a Grist table by row ID.

grist.delete_records

Frequently Asked Questions

Which names should I use for record fields?

Use column IDs from the table’s column definitions when filtering or writing records.

Can I update selected rows?

Yes. Provide the document, table, row IDs, and field changes you want applied.

Does this connection accept a self-hosted Grist URL?

This configuration targets Grist Cloud; a custom instance URL is not exposed.

Connect Grist

About Grist ↗