Grist MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | The logging level for the server. Options: DEBUG, INFO, WARNING, ERROR, CRITICAL. | INFO |
| GRIST_API_KEY | Yes | Your Grist API key, which can be found in your Grist account settings. | |
| GRIST_API_URL | No | Alternative environment variable name for the Grist API URL. | |
| GRIST_API_HOST | No | The host URL for the Grist API. | https://docs.getgrist.com/api |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_organizationsB | Liste toutes les organisations Grist accessibles. |
| describe_organizationC | Obtient des informations détaillées sur une organisation spécifique. |
| list_workspacesC | Liste tous les espaces de travail dans une organisation Grist. |
| describe_workspaceC | Obtient des informations détaillées sur un espace de travail spécifique. |
| list_documentsC | Liste tous les documents dans un espace de travail Grist. |
| describe_documentC | Obtient des informations détaillées sur un document spécifique. |
| list_tablesC | Liste toutes les tables dans un document Grist. |
| list_columnsC | Liste toutes les colonnes dans une table Grist. |
| list_recordsC | Liste les enregistrements dans une table Grist avec tri et limitation optionnels. |
| get_table_schemaB | Obtient le schéma détaillé d'une table Grist. |
| add_grist_recordsC | Ajoute des enregistrements à une table Grist. |
| add_grist_records_safeA | Ajoute des enregistrements avec validation préalable de la structure. Cette version sécurisée valide l'existence de la table et des colonnes avant d'ajouter les enregistrements, et suggère des corrections si nécessaire. |
| update_grist_recordsC | Met à jour des enregistrements existants dans une table Grist. |
| delete_grist_recordsC | Supprime des enregistrements d'une table Grist. |
| filter_sql_queryA | Exécute une requête SQL de filtrage sur une table Grist. Version simplifiée pour requêtes SQL courantes sans écrire de SQL. Pour requêtes complexes, utiliser execute_sql_query. |
| execute_sql_queryC | Exécute une requête SQL personnalisée sur un document Grist. Permet d'exécuter des requêtes SQL complexes avec jointures, agrégations et sous-requêtes. |
| modify_organizationC | Modifie les propriétés d'une organisation. |
| delete_organizationC | Supprime une organisation. |
| create_workspaceC | Crée un nouvel espace de travail dans une organisation. |
| modify_workspaceC | Modifie les propriétés d'un espace de travail. |
| delete_workspaceC | Supprime un espace de travail. |
| create_documentC | Crée un nouveau document dans un espace de travail. |
| modify_documentC | Modifie les propriétés d'un document. |
| delete_documentC | Supprime un document. |
| move_documentC | Déplace un document vers un autre espace de travail. |
| force_reload_documentB | Force le rechargement d'un document. Utile en cas d'incohérences ou de problèmes de synchronisation. |
| delete_document_historyB | Supprime l'historique d'un document, ne conservant que les dernières actions. Utile pour réduire la taille des documents volumineux. |
| create_tableC | Crée une nouvelle table dans un document. |
| modify_tableC | Modifie les propriétés d'une table. |
| create_columnC | Crée une nouvelle colonne dans une table. |
| modify_columnC | Modifie les propriétés d'une colonne. |
| delete_columnC | Supprime une colonne d'une table. |
| list_organization_accessC | Liste les utilisateurs ayant accès à une organisation. |
| modify_organization_accessC | Modifie l'accès d'un utilisateur à une organisation. |
| list_workspace_accessC | Liste les utilisateurs ayant accès à un espace de travail. |
| modify_workspace_accessC | Modifie l'accès d'un utilisateur à un espace de travail. |
| list_document_accessC | Liste les utilisateurs ayant accès à un document. |
| modify_document_accessC | Modifie l'accès d'un utilisateur à un document. |
| download_document_sqliteB | Télécharge un document Grist au format SQLite. |
| download_document_excelC | Télécharge un document Grist au format Excel. |
| download_table_csvC | Télécharge une table Grist au format CSV. |
| list_attachmentsC | Liste les pièces jointes d'un document Grist. |
| get_attachment_infoC | Obtient les métadonnées d'une pièce jointe. |
| download_attachmentC | Télécharge le contenu d'une pièce jointe. |
| upload_attachmentC | Téléverse une pièce jointe dans un document Grist. |
| list_webhooksC | Liste les webhooks d'un document Grist. |
| create_webhookC | Crée un webhook pour un document Grist. |
| modify_webhookC | Modifie un webhook existant. |
| delete_webhookC | Supprime un webhook. |
| clear_webhook_queueB | Vide la file d'attente des webhooks pour un document. Utile en cas d'accumulation de notifications non envoyées. |
| create_reference_columnA | Crée une colonne de référence qui affiche la colonne choisie de la table cible. Cette fonction:
|
| validate_schemaA | Valide un schéma sans le créer. Vérifie:
|
| create_schemaA | Crée un schéma complet avec tables, colonnes et relations. Algorithme:
Les tables déjà présentes dans le document ne sont jamais modifiées : ni colonnes, ni références, ni données ne leur sont ajoutées. Relancer le même schéma ne crée donc pas de doublons. Elles restent utilisables comme cibles de références. |
| export_schemaC | Exporte le schéma d'un document existant. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 54 tools
Most tools target a distinct resource+action (create_workspace, list_documents, delete_column), so an agent can usually select correctly. A few pairs overlap: add_grist_records vs add_grist_records_safe do the same operation with different validation, and filter_sql_query vs execute_sql_query both run SQL (though descriptions distinguish simple vs complex cases).
The dominant pattern is consistent French verb_noun (create_/list_/describe_/modify_/delete_ + resource). Minor deviations exist: get_table_schema uses 'get' where others use 'describe', the 'grist' qualifier appears only on add/update/delete records, and downloads use verb_noun_noun (download_document_sqlite). These are readable and don't break predictability.
54 tools is very heavy for agent navigation, well past the 25+ 'too many' threshold. The breadth mirrors Grist's real API (orgs, workspaces, docs, tables, columns, records, access, downloads, attachments, webhooks, schemas), so few tools are truly redundant, but the surface is unwieldy and would benefit from consolidation.
Coverage is broad and near-complete CRUD across the hierarchy plus specialized areas (schema validation/creation, references, attachments, webhooks, access, exports). Minor gaps exist, e.g. no create_organization and no single-record get (only list_records), but these are edge operations an agent can work around.