---
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). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 30 tools (14 read-only · 11 write · 5 destructive)
- Plan: available on all plans
- 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, approval required by default):

- `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?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 5 actions classified as destructive. Administrators configure that per tool.

### 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/