An AI assistant that works in your Grist documents

One entry point per audience

Set up in one minute

You need a Grist API key (in Grist: Profile settings → API) and the API address of your instance. uvx runs the server, no installation needed.

{
  "mcpServers": {
    "grist": {
      "command": "uvx",
      "args": ["mcp-server-grist"],
      "env": {
        "GRIST_API_KEY": "your_api_key",
        "GRIST_API_URL": "https://docs.getgrist.com/api"
      }
    }
  }
}

claude mcp add grist \
  -e GRIST_API_KEY=your_api_key \
  -e GRIST_API_URL=https://docs.getgrist.com/api \
  -- uvx mcp-server-grist

uvx mcp-server-grist

docker run -i --rm \
  -e GRIST_API_KEY=your_api_key \
  -e GRIST_API_URL=https://docs.getgrist.com/api \
  mcp/grist-mcp-server

What you can ask

• “In the Site tracking document, which sites are late this month?”
• “Create a Projects table and a Tasks table linked together, with a status choice column.”
• “Add these three contacts to the Partners table.”
• “Export the Registrations table to Excel.”
• “Who has access to the Budget document, and with which permissions?”

Grist's official MCP server or this one?

Since June 2026, Grist Labs offers its own MCP server. The two complement each other:

The 54 tools

Grouped by use. The reference details the parameters of each one. tools-reference.mdx

Read and export

• list_organizations Liste toutes les organisations Grist accessibles.
• describe_organization Obtient des informations détaillées sur une organisation spécifique.
• list_workspaces Liste tous les espaces de travail dans une organisation Grist.
• describe_workspace Obtient des informations détaillées sur un espace de travail spécifique.
• list_documents Liste tous les documents dans un espace de travail Grist.
• describe_document Obtient des informations détaillées sur un document spécifique.
• list_tables Liste toutes les tables dans un document Grist.
• list_columns Liste toutes les colonnes dans une table Grist.
• list_records Liste les enregistrements dans une table Grist avec tri et limitation optionnels.
• get_table_schema Obtient le schéma détaillé d'une table Grist.
• filter_sql_query Exécute une requête SQL de filtrage sur une table Grist.
• execute_sql_query Exécute une requête SQL personnalisée sur un document Grist.
• download_document_sqlite Télécharge un document Grist au format SQLite.
• download_document_excel Télécharge un document Grist au format Excel.
• download_table_csv Télécharge une table Grist au format CSV.
• list_attachments Liste les pièces jointes d'un document Grist.
• get_attachment_info Obtient les métadonnées d'une pièce jointe.
• download_attachment Télécharge le contenu d'une pièce jointe.
• export_schema Exporte le schéma d'un document existant.

Structure tables

• create_table Crée une nouvelle table dans un document.
• modify_table Modifie les propriétés d'une table.
• create_column Crée une nouvelle colonne dans une table.
• modify_column Modifie les propriétés d'une colonne.
• delete_column Supprime une colonne d'une table.
• create_reference_column Crée une colonne de référence qui affiche la colonne choisie de la table cible.
• validate_schema Valide un schéma sans le créer.
• create_schema Crée un schéma complet avec tables, colonnes et relations.

Edit data and documents

• add_grist_records Ajoute des enregistrements à une table Grist.
• add_grist_records_safe Ajoute des enregistrements avec validation préalable de la structure.
• update_grist_records Met à jour des enregistrements existants dans une table Grist.
• delete_grist_records Supprime des enregistrements d'une table Grist.
• modify_organization Modifie les propriétés d'une organisation.
• delete_organization Supprime une organisation.
• modify_workspace Modifie les propriétés d'un espace de travail.
• delete_workspace Supprime un espace de travail.
• modify_document Modifie les propriétés d'un document.
• delete_document Supprime un document.
• move_document Déplace un document vers un autre espace de travail.
• force_reload_document Force le rechargement d'un document.
• delete_document_history Supprime l'historique d'un document, ne conservant que les dernières actions.
• upload_attachment Téléverse une pièce jointe dans un document Grist.

Create

• create_workspace Crée un nouvel espace de travail dans une organisation.
• create_document Crée un nouveau document dans un espace de travail.

Access rights and webhooks

• list_organization_access Liste les utilisateurs ayant accès à une organisation.
• modify_organization_access Modifie l'accès d'un utilisateur à une organisation.
• list_workspace_access Liste les utilisateurs ayant accès à un espace de travail.
• modify_workspace_access Modifie l'accès d'un utilisateur à un espace de travail.
• list_document_access Liste les utilisateurs ayant accès à un document.
• modify_document_access Modifie l'accès d'un utilisateur à un document.
• list_webhooks Liste les webhooks d'un document Grist.
• create_webhook Crée un webhook pour un document Grist.
• modify_webhook Modifie un webhook existant.
• delete_webhook Supprime un webhook.
• clear_webhook_queue Vide la file d'attente des webhooks pour un document.

Before connecting your data

• The assistant acts with your API key: it can do anything you can do in Grist, including deleting. Use a key from an account with suitable permissions.
• SQL queries are read-only.
• In HTTP mode, the server does not authenticate its clients: keep it on 127.0.0.1 or behind an authenticated proxy.
• Re-running a schema creation creates nothing twice: existing tables are left untouched.

Related projects