obsidian-mcp

Gib Claude (und jedem MCP-Client) echten Agenten-Zugriff auf deinen Obsidian-Vault — Graph-Traversierung, Dataview-Abfragen, Bewusstsein für tägliche Notizen und mehr.

Installieren · Tools · Prompts zum Ausprobieren · Vergleich · FAQ

Die meisten Obsidian-MCP-Server stellen read_file und write_file bereit und das war es. Dieser hier behandelt deinen Vault als Wissensgraph — dein LLM erhält Backlinks, Forward-Links, Dataview-Abfragen, tägliche Notizen und Multi-Hop-Graph-Traversierung in einem einzigen Aufruf.

Warum

Du hast Claude Desktop geöffnet, es gebeten, Verbindungen in deinen Notizen zu finden, und zugesehen, wie es sich per read_file Notiz für Notiz durch deinen Vault gearbeitet hat. So denken Obsidian-Nutzer nicht über ihre Notizen nach. Der Graph ist der Wert — Backlinks, transitive Verbindungen, Tags, Dataview-typisierte Metadaten. Dieser Server stellt all das als erstklassige Tools bereit.

Installieren

Du benötigst das Plugin Local REST API in Obsidian. Installiere es über die Community-Plugins, aktiviere es und kopiere den API-Schlüssel aus den Einstellungen.

Claude Desktop

Füge dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp"],
      "env": {
        "OBSIDIAN_API_KEY": "paste-your-key-here"
      }
    }
  }
}

Starte Claude Desktop neu. Fertig.

Claude Code

claude mcp add obsidian -e OBSIDIAN_API_KEY=paste-your-key-here -- npx -y obsidian-mcp

Cursor / Cline / Continue / Zed

Jeder MCP-kompatible Client funktioniert. Verweise ihn auf npx -y obsidian-mcp mit OBSIDIAN_API_KEY in der Umgebung.

Aus dem Quellcode

git clone https://github.com/yanxue06/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run build
OBSIDIAN_API_KEY=... node dist/index.js

Prompts zum Ausprobieren

Gib diese in Claude Desktop ein, während der Server verbunden ist:

Erstelle mir eine Inhaltsübersicht (MOC) für alles, was ich über verteilte Systeme geschrieben habe. Verwende traverse_graph von "Distributed systems.md" mit Tiefe 2, gruppiere die Nachbarn thematisch und schreibe die MOC in "MOCs/Distributed systems MOC.md".

Finde jede Notiz mit dem Tag #project, bei der status != "done" ist und das Fälligkeitsdatum in dieser Woche liegt. Verwende query_dataview.

Was steht heute in meiner täglichen Notiz? Gibt es etwas, bei dem ich vergessen habe, von der gestrigen Notiz aus nachzufassen?

Finde alle meine verwaisten Notizen in Inbox/. Schlage für jede basierend auf ihrem Inhalt und vorhandenen Tags vor, wo sie hingehört.

Ich benenne "Atomic notes.md" in "Evergreen notes.md" um. Finde jede Notiz, die darauf verlinkt, und sage mir, welche ich aktualisieren müsste.

Durchlaufe den Graphen 2 Hops weit von "Working memory.md" aus und sage mir, welche Notizen für mein Denken über Aufmerksamkeit am zentralsten sind.

Tools

Insgesamt 15 Tools. Die differenzierten sind fett gedruckt.

Lesen

Suche & Graph

Schreiben

Vergleich

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen — setze diese in deiner MCP-Client-Konfiguration.

Funktionsweise

┌──────────────┐     stdio (MCP)      ┌──────────────┐    HTTPS     ┌──────────────────┐
│ Claude / IDE │ ───────────────────► │ obsidian-mcp │ ───────────► │  Local REST API  │ ──► Vault
└──────────────┘                      └──────────────┘              │ (Obsidian plugin)│
                                                                    └──────────────────┘

obsidian-mcp ist eine dünne Schicht über dem Local REST API-Plugin. Das Plugin betreibt einen HTTPS-Server innerhalb von Obsidian mit vollem Vault-Zugriff; dieser Server adaptiert diese Oberfläche in das MCP-Protokoll und fügt graph-bewusste Tools hinzu, die die REST-API von Obsidian nicht direkt bereitstellt (Backlinks, Multi-Hop-Traversierung, Erkennung verwaister Notizen).

Alles ist lokal. Keine Daten verlassen deinen Rechner, außer den Anfragen, die dein MCP-Client an seinen Modellanbieter stellt — und das kontrollierst du.

FAQ

Muss ich ein Obsidian-Plugin installieren? Ja — das Local REST API-Plugin. Es ist der einzige vernünftige Weg, von außen mit einem laufenden Vault zu kommunizieren. Sobald es installiert ist, läuft obsidian-mcp selbst als separater Node-Prozess, der von deinem MCP-Client gestartet wird; du installierst dafür kein weiteres Plugin in Obsidian.

Funktioniert es, wenn Obsidian geschlossen ist? Nein. Die Local REST API läuft innerhalb von Obsidian, daher muss die App geöffnet sein.

Werden mehrere Vaults unterstützt? Eine Serverinstanz verweist auf eine laufende Obsidian-Instanz. Starte mehrere MCP-Server-Einträge (verschiedene Namen + verschiedene Ports), wenn du häufig zwischen Vaults wechselst.

Warum standardmäßig HTTPS mit OBSIDIAN_VERIFY_TLS=false? Das Plugin liefert ein selbstsigniertes Zertifikat mit. Der Datenverkehr ist nur Loopback (127.0.0.1), daher bietet die Verifizierung Reibung ohne echten Sicherheitsgewinn. Wenn du das Zertifikat ersetzt hast, setze das Flag.

Ist das sicher? Der MCP-Server gibt dem Modell den Zugriff, den der API-Schlüssel gewährt. Alles, was das Modell löschen darf, kann es löschen. Behandle es wie jeden Agenten mit Dateischreibzugriff — überprüfe, was er tun wird, besonders vor Massenoperationen.

Roadmap

• [ ] Einbettungsbasierte semantische Suche (derzeit nur Schlüsselwortsuche über das Plugin)

• [ ] Workspace-Wechsel / Multi-Vault-Routing

• [ ] Schreibgeschützter Sicherheitsmodus (keine Schreib-Tools registriert)

• [ ] Ressourcen-Abonnements (Push-Updates, wenn sich Notizen ändern)

• [ ] Smithery / mcp-get Registry-Einreichung

PRs sind willkommen. Siehe CONTRIBUTING.md.

Danksagungen

• Local REST API von @coddingtonbear — dieses gesamte Projekt basiert darauf.

• Das Model Context Protocol-Team bei Anthropic.

Lizenz

MIT — siehe LICENSE.