Un assistant IA qui travaille dans vos documents Grist

Une porte d'entrée par public

Installer en une minute

Il vous faut une clé API Grist (dans Grist : Paramètres du profil → API) et l'adresse de l'API de votre instance. Le serveur est lancé par uvx, sans installation préalable.

{
  "mcpServers": {
    "grist": {
      "command": "uvx",
      "args": ["mcp-server-grist"],
      "env": {
        "GRIST_API_KEY": "votre_clé_api",
        "GRIST_API_URL": "https://grist.numerique.gouv.fr/api"
      }
    }
  }
}

claude mcp add grist \
  -e GRIST_API_KEY=votre_clé_api \
  -e GRIST_API_URL=https://grist.numerique.gouv.fr/api \
  -- uvx mcp-server-grist

uvx mcp-server-grist

docker run -i --rm \
  -e GRIST_API_KEY=votre_clé_api \
  -e GRIST_API_URL=https://grist.numerique.gouv.fr/api \
  mcp/grist-mcp-server

Ce que vous pouvez lui demander

• « Dans le document Suivi des chantiers, quels chantiers sont en retard ce mois-ci ? »
• « Crée une table Projets et une table Tâches reliées entre elles, avec un statut à choix. »
• « Ajoute ces trois contacts à la table Partenaires. »
• « Exporte la table Inscriptions en Excel. »
• « Qui a accès au document Budget, et avec quels droits ? »

Serveur MCP officiel de Grist ou celui-ci ?

Grist Labs propose depuis juin 2026 son propre serveur MCP. Les deux se complètent :

Les 54 outils

Rangés par usage. La référence détaille les paramètres de chacun. tools-reference.mdx

Consulter et exporter

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

Structurer les 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.

Modifier les données et les 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.

Créer

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

Droits d'accès et 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.

À savoir avant de brancher vos données

• L'assistant agit avec votre clé API : il peut faire tout ce que vous pouvez faire dans Grist, y compris supprimer. Utilisez une clé d'un compte aux droits adaptés.
• Les requêtes SQL sont limitées à la lecture.
• En mode HTTP, le serveur n'authentifie pas ses clients : gardez-le sur 127.0.0.1 ou derrière un proxy authentifié.
• Relancer la création d'un schéma ne crée rien en double : les tables existantes ne sont pas modifiées.

Projets liés