---
title: "Grist integration for LuumenAI"
url: "https://www.luumen.ai/integrations/grist/"
entity: SoftwareIntegration
category: "Project management"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Grist integration for LuumenAI

Read Grist tables for context, then add or update records as approved steps

## What LuumenAI can do with Grist

LuumenAI connects to Grist with an API token and exposes 30 tools (14 read-only · 11 write · 5 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 30 tools (14 read-only · 11 write · 5 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Project management

## About Grist with LuumenAI

Operations teams keep a lot in Grist: on-call rosters, asset inventories, change logs, vendor lists. Luumen connects with an API key and reads your documents, tables, columns, and records directly in the terminal. When something needs to change, it shows the rows it plans to write and waits for your approval first.

## Example tools

Read-only (14 in total):

- `GRIST_DOWNLOAD_ALL_ATTACHMENTS_ARCHIVE` — Download all attachments from a Grist document as a single archive file (.zip or .tar).
- `GRIST_DOWNLOAD_ATTACHMENT` — Download a file attachment from a Grist document.
- `GRIST_FETCH_DOCUMENT_METADATA` — Fetch metadata for a specified Grist document.
- `GRIST_FETCH_TABLE_METADATA` — Retrieve metadata for a specified table in a Grist document.
- `GRIST_GET_ORG_ACCESS` — Retrieves the list of users who have access to a Grist organization along with their access roles (owners, editors, viewers).
- `GRIST_GET_USERS` — Retrieve a list of users via SCIM v2.
- `GRIST_LIST_ATTACHMENTS` — List all attachments in a Grist document.
- `GRIST_LIST_COLUMNS` — List all columns in a specified Grist table.

Write and destructive (16 in total, subject to configured approval policy):

- `GRIST_ADD_RECORDS` — Add one or more records to a Grist table.
- `GRIST_CREATE_DOCUMENT` — Creates a new Grist document in a specified workspace.
- `GRIST_CREATE_SCIM_USER` — Create a new SCIM user.
- `GRIST_CREATE_TABLE` — Create tables in a document.
- `GRIST_CREATE_WEBHOOK` — Create a new webhook for a specified document.
- `GRIST_DELETE_ATTACHMENT` — Remove unused attachments from a Grist document to free up storage space.
- `GRIST_DELETE_COLUMN` — Delete a column from a Grist document table.
- `GRIST_DELETE_RECORDS` — Delete records from a specified Grist table.

## Frequently asked questions

### How does LuumenAI connect to Grist?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Grist on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Grist — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/grist/
