io.github.HugoF1234/gilbert-mcp

gilbert-mcp

Serveur Model Context Protocol (MCP) officiel de Gilbert.

Permet à Claude Desktop, Claude Code, Cursor, VS Code, Zed, Continue et tous les clients compatibles MCP d'accéder aux réunions, transcriptions et synthèses Gilbert d'un utilisateur — en lecture seule.

Installation rapide

Toutes les configs partagent la même commande : npx -y gilbert-mcp avec la variable GILBERT_API_KEY.

Claude Desktop

Éditez le fichier de configuration :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gilbert": {
      "command": "npx",
      "args": ["-y", "gilbert-mcp"],
      "env": {
        "GILBERT_API_KEY": "glbrt_live_XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Redémarrez Claude Desktop. Vous pouvez maintenant demander :

« Liste mes réunions terminées cette semaine » « Résume-moi la réunion du 12 avril » « Trouve-moi la réunion où on a parlé de budget Q3 »

Claude Code

claude mcp add gilbert --env GILBERT_API_KEY=glbrt_live_XXX -- npx -y gilbert-mcp

Cursor

Settings > Features > Model Context Protocol > Add MCP Server :

{
  "name": "gilbert",
  "command": "npx",
  "args": ["-y", "gilbert-mcp"],
  "env": { "GILBERT_API_KEY": "glbrt_live_XXXXXXXXXXXXXXXXXXXXXXXX" }
}

VS Code

.vscode/mcp.json (ou la commande MCP: Add Server) :

{
  "servers": {
    "gilbert": {
      "command": "npx",
      "args": ["-y", "gilbert-mcp"],
      "env": { "GILBERT_API_KEY": "glbrt_live_XXXXXXXXXXXXXXXXXXXXXXXX" }
    }
  }
}

Zed

Dans settings.json, sous context_servers :

{
  "context_servers": {
    "gilbert": {
      "command": { "path": "npx", "args": ["-y", "gilbert-mcp"], "env": { "GILBERT_API_KEY": "glbrt_live_XXX" } }
    }
  }
}

Docker (alternative)

docker build -t gilbert-mcp .
docker run --rm -i -e GILBERT_API_KEY=glbrt_live_XXX gilbert-mcp

Obtenir une clé API

Contactez votre administrateur Gilbert pour qu'il génère une clé depuis la console admin. Scope minimum requis : meetings:read (lecture seule).

Tools exposés

Tous les tools sont en lecture seule (readOnlyHint).

Tool	Description
list_meetings	Liste paginée, filtres par statut/date
get_meeting	Détail complet d'une réunion (metadata + transcription + synthèse)
get_transcript	Transcription texte seule
get_summary	Synthèse markdown seule
search_meetings	Recherche full-text
list_folders	Liste les dossiers (nom + nombre de réunions)
get_folder_meetings	Réunions d'un dossier (et sous-dossiers)

Le contenu partagé avec l'utilisateur (réunions/dossiers d'autres personnes) n'est accessible que si la clé API porte le scope shared:read. Par défaut, une clé ne voit que le contenu de son propriétaire.

Variables d'environnement

• GILBERT_API_KEY (requis) : clé au format glbrt_live_...
• GILBERT_BASE_URL (optionnel) : défaut https://gilbert-assistant.ovh/api/v1

Confidentialité & sécurité

Ce serveur expose des transcriptions et synthèses de réunions (données potentiellement sensibles). Il s'exécute localement en stdio, n'ouvre aucun port entrant, ne journalise jamais la clé API et n'écrit aucune donnée de réunion sur disque. Voir SECURITY.md.

Développement

git clone https://github.com/HugoF1234/Gilbert-mcp
cd Gilbert-mcp
npm install
GILBERT_API_KEY=glbrt_live_... npm run dev   # stdio
npm test                                     # build + smoke test (handshake MCP)

Voir CONTRIBUTING.md pour le process de release et docs/SUBMISSION.md pour le référencement dans les catalogues.

Licence

MIT — © 2026 Lexia.

Support

• Documentation API : https://gilbert-assistant.ovh/api/v1/docs
• Contact : contact@lexiapro.fr