Grist MCP Server
About
Integrate with the Grist API to manage relational spreadsheets and data. Requires a Grist API key.
Details
- License
- MIT
Explore
- List organizations, workspaces, documents, tables, and columns
- Create, read, update, and delete records in Grist tables
- Execute SQL queries (SELECT only) with parameters and timeouts
- Filter and sort data with advanced querying capabilities
- Manage user access to organizations, workspaces, and documents
- Export documents as SQLite, Excel, or CSV; handle attachments and webhooks
- Validate and create safe formulas for columns
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Grist MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Pour contribuer ou personnaliser le serveur :
``bash
pip install -e .
cp .env.example .env
Ajoutez ceci à votre claude_desktop_config.json` :
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"grist mcp server": {
"mcp-server-grist": {
"command": "uvx",
"args": [
"mcp-server-grist"
]
}
}
}
}McpServers
{
"mcp-server-grist": {
"command": "uvx",
"args": [
"mcp-server-grist"
]
}
}
Un serveur MCP (Model Context Protocol) pour interagir avec l'API Grist. Ce serveur permet d'accéder et de manipuler les données Grist directement depuis des modèles de langage comme Claude.
Structure du projet
mcp-server-grist/
├── src/
│ └── mcp_server_grist/ # Package principal
│ ├── __init__.py # Point d'entrée du package
│ ├── __main__.py # Support pour exécution en module
│ ├── version.py # Gestion de version
│ ├── main.py # Point d'entrée principal
│ ├── server.py # Configuration du serveur MCP
│ ├── client.py # Client API Grist
│ ├── tools/ # Outils MCP organisés par catégorie
│ └── models.py # Modèles de données Pydantic
├── tests/ # Tests unitaires et d'intégration
├── docs/ # Documentation détaillée
├── requirements.txt # Dépendances Python
├── pyproject.toml # Configuration moderne du package
├── Dockerfile # Configuration Docker
├── docker-compose.yml # Configuration multi-services
├── .env.template # Template pour variables d'environnement
└── README.md # Documentation principale
Prérequis
- Python 3.8+
- Une clé API Grist valide
- Les packages Python suivants : fastmcp, httpx, pydantic, python-dotenv
Utilisation à la volée
Via uvx (recommandé)
En utilisant uvx, l'environnement et le téléchargement des paquets se fait à la volée au moment de l'éxécution
uvx mcp-server-grist
Utilisation avec votre Assitant IA favori qui supporte le protocole MCP
La configuration en json est :
{
"mcpServers": {
"grist-server": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-grist"
],
"env": {
"GRIST_API_KEY": "ta_cle_API_GRIST"
}
}
}
}
Installation
Via pip
pip install mcp-server-grist
Après l'installation, vous pouvez exécuter le serveur avec :
mcp-server-grist
Utilisation avec Claude Desktop
Pour utiliser ce serveur MCP avec Claude Desktop, ajoutez la configuration suivante à votre fichier mcp_servers.json :
{
"mcpServers": {
"grist-mcp": {
"command": "node",
"args": [
"chemin/vers/npm-wrapper/bin/start.js"
],
"env": {
"GRIST_API_KEY": "votre_clé_api_grist",
"GRIST_API_URL": "https://docs.getgrist.com/api"
}
}
}
}
Remplacez chemin/vers/npm-wrapper/bin/start.js par le chemin absolu vers le script start.js du wrapper Node.js inclus dans ce package.
Installation en mode développement
Pour contribuer ou personnaliser le serveur :
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
