Graph Context for Claude Code

Jeune plugin Obsidian qui connecte le vault au sélecteur /ide de Claude Code : la sélection de texte envoie automatiquement le contexte du graphe (liens résolus, backlinks, chemin des titres).

Ce plugin très récent (juin 2026) rend Obsidian visible dans le mécanisme IDE intégré de Claude Code — le même procédé de fichier de verrouillage plus WebSocket local qu'utilisent aussi les extensions officielles VS Code et JetBrains. Au chargement, le plugin démarre un serveur WebSocket sur 127.0.0.1 et écrit un fichier de verrouillage contenant le port, le chemin du vault et un token d'authentification de session dans ~/.config/claude/ide/<port>.lock ou ~/.claude/ide/<port>.lock. Claude Code trouve automatiquement ce fichier, se connecte, s'authentifie avec le token, puis parle MCP via JSON-RPC. La véritable valeur ajoutée réside dans la couche « Graph Context » : lorsqu'on sélectionne du texte dans une note, le plugin n'envoie pas seulement le Markdown brut avec des [[liens]] opaques, mais les résout côté serveur avec le propre résolveur metadataCache d'Obsidian, et envoie le tout dans un seul payload — les ![[embeds]] intégrés en entier, les [[wikilinks]] sous forme résumée (frontmatter + premier paragraphe), le chemin de titres du curseur, le frontmatter et les backlinks. La différence avec les serveurs MCP Obsidian classiques : là, Claude doit résoudre chaque lien individuellement via un appel d'outil (N liens = N×2 allers-retours) ; ici, le contexte résolu accompagne automatiquement la sélection, sans appels d'outil supplémentaires. La résolution est volontairement limitée à un seul niveau de profondeur (les liens d'un lien déjà résolu ne sont pas développés davantage) et à une taille limitée (embeds 2000 caractères, résumés de wikilinks 200, total 8000, backlinks 20), avec des indicateurs de troncature explicites plutôt qu'une coupe silencieuse. Ne fonctionne que sur Obsidian desktop, car un serveur WebSocket Node est nécessaire.

🔧 SETUP

Nécessite Obsidian desktop (le plugin est isDesktopOnly) ainsi qu'une installation fonctionnelle de Claude Code dans le terminal.
Compiler manuellement, car il n'existe pas encore de fiche dans les plugins communautaires : cloner le dépôt, puis `npm install && npm run build`.
Copier `main.js` et `manifest.json` dans son propre vault : `<vault>/.obsidian/plugins/graph-context-for-claude-code/`.
Dans Obsidian, sous Settings → Community plugins, désactiver le Restricted Mode (si nécessaire) et activer « Graph Context for Claude Code » — un message « ready on port <PORT> » apparaît.
Dans un terminal séparé, lancer `claude`, saisir `/ide` et sélectionner « Obsidian » ; puis sélectionner du texte dans une note et interroger Claude directement après.

✅ QUAND L’UTILISER ?

Notes fortement liées comme contexte pour une question

En sélectionnant un paragraphe qui renvoie vers plusieurs autres notes, puis en demandant « Résume ce que j'ai sélectionné et son lien avec les notes liées », Claude dispose déjà du contenu lié dès le premier payload, sans devoir recharger chaque lien individuellement.

Questions rapides sur une note unique sans configuration de clé API

Pour qui souhaite accéder occasionnellement, pendant une session de codage dans Claude Code, à une seule note Obsidian, pas besoin du serveur HTTPS séparé ni de la clé API de la solution Local REST API — `/ide` et la sélection d'Obsidian suffisent.

⛔ QUAND ÉVITER ?

Utilisation mobile ou automatisation sans application Obsidian ouverte

Le plugin est explicitement isDesktopOnly et nécessite une instance Obsidian desktop active avec un serveur WebSocket en fonctionnement — il n'existe pas de mode headless.

Mieux: Pour une automatisation sans application Obsidian ouverte, utiliser Obsidian Local REST API avec son serveur HTTPS autonome.

Liens à plusieurs sauts en profondeur devant être inclus automatiquement

L'expansion du graphe est volontairement limitée à une profondeur de 1 — les liens à l'intérieur d'une note déjà résolue par expansion ne sont pas résolus davantage.

Mieux: Pour un parcours de graphe plus profond, utiliser de façon ciblée les outils MCP de Local REST API ou un outil de graphe dédié comme Graphify avec export Obsidian.