Skip to main content
Glama
Grist MCP Server
by nic01asFr

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNoThe logging level for the server. Options: DEBUG, INFO, WARNING, ERROR, CRITICAL.INFO
GRIST_API_KEYYesYour Grist API key, which can be found in your Grist account settings.
GRIST_API_URLNoAlternative environment variable name for the Grist API URL.
GRIST_API_HOSTNoThe 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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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:

  1. Vérifie que les tables source et cible existent

  2. Résout le nom (ID ou libellé) de la colonne visible

  3. Crée la colonne de référence et règle son affichage

  4. Optionnellement crée la relation inverse (référence à double sens Grist : les deux colonnes restent synchronisées)

validate_schemaA

Valide un schéma sans le créer.

Vérifie:

  • Syntaxe du schéma

  • Existence des tables cibles pour les références

  • Existence des colonnes visibles ('visible') dans les tables cibles

  • Absence de conflit pour les colonnes inverses ('reverse')

  • Colonnes Choice/ChoiceList sans choix (avertissement)

create_schemaA

Crée un schéma complet avec tables, colonnes et relations.

Algorithme:

  1. Validation du schéma (rien n'est créé si elle échoue)

  2. Création des tables avec leurs colonnes simples

  3. Création des colonnes de référence (colonne affichée réglée)

  4. Création des relations inverses (références à double sens)

  5. Insertion des données (optionnel)

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.8/5.0

Scored across 54 tools

Disambiguation4/5

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).

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessOutdated data