Graph Context for Claude Code

Junges Obsidian-Plugin, das den Vault in Claude Codes /ide-Auswahl einklinkt: Beim Markieren von Text wird automatisch Graph-Kontext (aufgelöste Links, Backlinks, Überschriften-Pfad) mitgesendet.

Dieses sehr junge Plugin (Juni 2026) macht Obsidian in Claude Codes eingebautem IDE-Mechanismus sichtbar — demselben Lock-File-plus-lokalem-WebSocket-Verfahren, das auch die offiziellen VS-Code- und JetBrains-Extensions nutzen. Beim Laden startet das Plugin einen WebSocket-Server auf 127.0.0.1 und schreibt eine Lock-Datei mit Port, Vault-Pfad und einem Session-Auth-Token nach ~/.config/claude/ide/<port>.lock bzw. ~/.claude/ide/<port>.lock. Claude Code findet diese Datei automatisch, verbindet sich, authentifiziert sich mit dem Token und spricht anschließend MCP über JSON-RPC. Der eigentliche Mehrwert liegt in der „Graph Context"-Schicht: Wählt man Text in einer Notiz aus, sendet das Plugin nicht nur den rohen Markdown mit undurchsichtigen [[Links]], sondern löst diese serverseitig mit Obsidians eigenem metadataCache-Resolver auf und schickt alles in einem Payload mit — eingebettete ![[Embeds]] komplett, [[Wikilinks]] als Kurzfassung (Frontmatter + erster Absatz), den Überschriften-Pfad des Cursors, Frontmatter und Backlinks. Der Unterschied zu klassischen Obsidian-MCP-Servern: Dort muss Claude jeden Link einzeln per Tool-Call auflösen (N Links = N×2 Roundtrips); hier kommt der aufgelöste Kontext automatisch mit der Selektion mit, ohne Zusatz-Tool-Calls. Die Auflösung ist bewusst nur eine Ebene tief (Links eines bereits verlinkten Links werden nicht weiter expandiert) und größenbegrenzt (Embeds 2000 Zeichen, Wikilink-Zusammenfassungen 200, insgesamt 8000, Backlinks 20), mit expliziten Truncated-Flags statt stillem Abschneiden. Läuft nur auf Desktop-Obsidian, da ein Node-WebSocket-Server nötig ist.

🔧 SETUP

Desktop-Obsidian voraussetzen (Plugin ist isDesktopOnly) sowie eine funktionierende Claude-Code-Installation im Terminal.
Manuell bauen, da es noch kein Community-Plugin-Listing gibt: Repo klonen, dann `npm install && npm run build`.
`main.js` und `manifest.json` in den eigenen Vault kopieren: `<vault>/.obsidian/plugins/graph-context-for-claude-code/`.
In Obsidian unter Settings → Community plugins den Restricted Mode deaktivieren (falls nötig) und „Graph Context for Claude Code" aktivieren — es erscheint eine Meldung „ready on port <PORT>".
In einem separaten Terminal `claude` starten, `/ide` eingeben und „Obsidian" auswählen; danach Text in einer Notiz markieren und Claude direkt danach fragen.

✅ WANN EINSETZEN?

Notizen mit vielen Verlinkungen als Kontext für eine Frage

Markiert man einen Absatz, der auf mehrere andere Notizen verlinkt, und fragt „Fasse zusammen, was ich markiert habe und wie es mit den verlinkten Notizen zusammenhängt", hat Claude die verlinkten Inhalte schon im ersten Payload, ohne jeden Link einzeln nachzuladen.

Schnelle Rückfragen zu einer einzelnen Notiz ohne API-Key-Setup

Wer nur gelegentlich während einer Coding-Session in Claude Code auf eine einzelne Obsidian-Notiz zugreifen will, kommt ohne den separaten HTTPS-Server samt API-Key der Local-REST-API-Lösung aus — hier reicht `/ide` und die Auswahl von Obsidian.

⛔ WANN EHER NICHT?

Mobile Nutzung oder Automatisierung ohne offene Obsidian-App

Das Plugin ist explizit isDesktopOnly und braucht eine laufende Desktop-Obsidian-Instanz mit aktivem WebSocket-Server — es gibt keinen headless-Modus.

Besser: Für Automatisierung ohne offene Obsidian-App die Obsidian Local REST API mit ihrem eigenständigen HTTPS-Server nutzen.

Tiefe Mehrfach-Hop-Verlinkungen sollen automatisch mitkommen

Die Graph-Expansion ist bewusst auf Tiefe 1 begrenzt — Links innerhalb einer bereits expandierten verlinkten Notiz werden nicht weiter aufgelöst.

Besser: Für tiefere Graph-Traversierung gezielt die MCP-Tools der Local REST API oder ein dediziertes Graph-Tool wie Graphify mit Obsidian-Export einsetzen.