Coda MCP Server

Connecteur MCP (Model Context Protocol) pour intégrer Coda.io dans Claude Code et Claude Desktop.

Permet à Claude d'accéder directement à vos docs, pages, tables et données Coda depuis une conversation — lire, écrire, filtrer, créer, sans quitter Claude.

---

Table des matières

• Pourquoi ce MCP ?
• Outils disponibles
• Installation
  • Prérequis
  • Option A — Via npx (recommandé)
  • Option B — Via clone git
  • Configuration Claude Code
  • Configuration Claude Desktop
  • Installer le skill Coda Formulas
• Exemples d'utilisation
• Mise à jour
• Sécurité
• Contribution

---

Pourquoi ce MCP ?

Coda.io est un outil puissant mais répétitif pour les tâches de données. Ce MCP connecte Claude directement à votre compte Coda, vous permettant par exemple de :

• "Montre-moi toutes les tâches non terminées dans mon projet"
• "Ajoute une ligne dans ma table de dépenses"
• "Résume le contenu de ma page de notes de réunion"
• "Copie la page template de janvier vers février"

Tout sans ouvrir Coda, sans copier-coller, en langage naturel.

---

Outils disponibles

Documents & Pages

Outil	Description
coda_list_docs	Lister / rechercher des documents
coda_get_doc	Obtenir les métadonnées d'un doc
coda_create_doc	Créer un nouveau document
coda_search_docs	Rechercher parmi tous les docs
coda_list_pages	Lister les pages d'un doc
coda_update_page	Modifier le titre / icône d'une page
coda_get_page_content	Lire le contenu complet d'une page (markdown)
coda_peek_page	Aperçu des N premières lignes d'une page
coda_create_page	Créer une nouvelle page avec contenu optionnel
coda_replace_page_content	Remplacer entièrement le contenu d'une page
coda_append_page_content	Ajouter du contenu à la fin d'une page
coda_duplicate_page	Dupliquer une page sous un nouveau nom
coda_resolve_link	Résoudre une URL Coda en métadonnées

Tables & Données

Outil	Description
coda_list_tables	Lister les tables et vues d'un doc
coda_list_columns	Lister les colonnes d'une table
coda_list_rows	Lister les lignes avec filtres et tri
coda_get_row	Obtenir une ligne spécifique
coda_upsert_rows	Insérer ou mettre à jour des lignes
coda_update_row	Modifier une ligne existante
coda_delete_row	Supprimer une ligne
coda_delete_rows	Supprimer plusieurs lignes en une opération
coda_push_button	Déclencher un bouton sur une ligne

Formules

Outil	Description
coda_list_formulas	Lister les formules nommées avec leurs valeurs calculées

---

Installation

Prérequis

• Node.js v18 ou supérieur
• Claude Code ou Claude Desktop
• Un compte Coda.io avec un token API

Obtenir un token API Coda

1. Aller sur coda.io/account
2. Section API Settings → Generate API token
3. Laisser le champ "Doc or table" vide pour accéder à tous vos docs
4. Copier le token généré

⚠️ Ne jamais committer votre token dans le code. Passez-le toujours via variable d'environnement.

---

Option A — Via npx (recommandé)

Aucune installation requise. Ajoutez directement dans votre config :

Claude Code :

claude mcp add coda npx -y @thierryvm/coda-mcp-server@latest \
  --env CODA_API_TOKEN=VOTRE_TOKEN_ICI \
  -s user

Claude Desktop (claude_desktop_config.json) :

{
  "mcpServers": {
    "coda": {
      "command": "npx",
      "args": ["-y", "@thierryvm/coda-mcp-server@latest"],
      "env": {
        "CODA_API_TOKEN": "VOTRE_TOKEN_ICI"
      }
    }
  }
}

---

Option B — Via clone git

Utile si vous souhaitez modifier le code ou contribuer.

git clone https://github.com/thierryvm/coda-mcp-server.git
cd coda-mcp-server
npm install
npm run build

Claude Code :

claude mcp add coda node /chemin/vers/coda-mcp-server/dist/index.js \
  --env CODA_API_TOKEN=VOTRE_TOKEN_ICI \
  -s user

Remplacez /chemin/vers/coda-mcp-server/ par le chemin réel :

• Windows : C:\Users\VotreNom\Documents\coda-mcp-server
• macOS/Linux : /home/votreNom/Documents/coda-mcp-server

---

Configuration Claude Desktop

Localisez le fichier claude_desktop_config.json :

OS	Chemin
Windows (Store)	%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\
Windows (classique)	%APPDATA%\Claude\
macOS	~/Library/Application Support/Claude/

Ajoutez la configuration :

{
  "mcpServers": {
    "coda": {
      "command": "node",
      "args": ["/chemin/vers/coda-mcp-server/dist/index.js"],
      "env": {
        "CODA_API_TOKEN": "VOTRE_TOKEN_ICI"
      }
    }
  }
}

Puis redémarrez Claude Desktop.

---

Installer le skill Coda Formulas (optionnel)

Le fichier coda-formulas.plugin inclus dans ce repo ajoute à Claude une référence complète des formules Coda. Il s'active automatiquement quand vous travaillez avec des formules.

Installation : glisser-déposer coda-formulas.plugin dans la fenêtre Claude Code.

Ou manuellement :

# macOS/Linux
cp -r skills ~/.claude/

# Windows (PowerShell)
Copy-Item -Recurse skills\coda-formulas "$env:USERPROFILE\.claude\plugins\repos\coda-formulas\skills"

---

Exemples d'utilisation

Une fois configuré, voici ce que vous pouvez demander à Claude :

"Liste mes 10 derniers documents Coda"
"Montre-moi les colonnes de la table Projets dans mon doc Planning"
"Ajoute une dépense de 45€ pour 'électricité' dans ma table budget"
"Lis le contenu de ma page Réunion du 15 mars"
"Duplique la page Template janvier en Template février"
"Quelles sont les formules de mon budget et leurs valeurs ?"
"Supprime toutes les lignes où le statut est Archivé"

---

Mise à jour

Via npx : automatique à chaque utilisation (@thierryvm/coda-mcp-server@latest).

Via clone git :

git pull
npm run build

Puis relancer Claude Code / Claude Desktop.

---

Sécurité

• Token API passé via variable d'environnement, jamais dans le code
• Serveur en local (stdio) — aucun port réseau exposé
• Toutes les URLs externes validées pour appartenir à coda.io
• Limite de 100KB sur les écritures de contenu
• Paramètres validés avec Zod (.strict())

Voir SECURITY.md pour signaler une vulnérabilité.

---

Contribution

Les contributions sont les bienvenues ! Voir CONTRIBUTING.md pour le workflow complet.

Pour signaler un bug ou proposer une fonctionnalité : ouvrir une issue.

---

Créé avec Claude Cowork — Licence MIT