Obsidian Local REST API

★ 2.635

Community-Plugin, das einen lokalen HTTPS-Server in Obsidian startet — seit 2026 mit eingebautem MCP-Endpunkt: Notizen lesen/schreiben, Vault durchsuchen.

Obsidian Local REST API ist ein Community-Plugin, das beim Start einen lokalen HTTPS-Server auf 127.0.0.1:27124 hochfährt (selbstsigniertes Zertifikat; optional zusätzlich HTTP auf Port 27123, muss extra aktiviert werden). Jede Anfrage wird per API-Key abgesichert, den du in den Plugin-Einstellungen findest und als Bearer-Token mitschickst. Über REST-Endpunkte lassen sich Notizen lesen, schreiben, patchen und löschen (/vault/{path}), die gerade offene Datei bearbeiten (/active/), Volltext durchsuchen (/search/simple/), komplexere Metadatensuchen per JsonLogic fahren (/search/), Tags auflisten oder Obsidian-Befehle auslösen (/commands/).

Seit 2026 bringt das Plugin zusätzlich einen eingebauten MCP-Endpunkt unter /mcp/ mit (Streamable-HTTP-Transport, gleiche Authentifizierung wie die REST-API), der über 15 Tools wie vault_read, vault_write oder search_query bereitstellt. Claude Code unterstützt HTTP-MCP nativ und lässt sich per CLI-Befehl direkt mit diesem Endpunkt verbinden — ein separater MCP-Server-Prozess ist damit nicht mehr nötig. Claude Desktop spricht kein natives HTTP-MCP und braucht dafür laut Doku eine Brücke wie mcp-remote. Damit wird der eigene Obsidian-Vault zu einer durchsuchbaren, beschreibbaren Wissensquelle für den Agenten — alles lokal auf dem eigenen Rechner, ohne dass Daten ihn verlassen müssen.

🔧 SETUP

Plugin "Local REST API" über Obsidian Community Plugins installieren und aktivieren
In Obsidian: Settings → Local REST API öffnen, API-Key kopieren, ggf. das selbstsignierte Zertifikat vertrauen
Erreichbarkeit testen: GET https://127.0.0.1:27124/ liefert ohne Authentifizierung einen Status-Check zurück
Claude Code verbinden: `claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ --header "Authorization: Bearer <your-api-key>"`
Alternativ manuell in `.mcp.json` eintragen: `{"mcpServers":{"obsidian":{"type":"http","url":"https://127.0.0.1:27124/mcp/","headers":{"Authorization":"Bearer <your-api-key>"}}}}`

✅ WANN EINSETZEN?

Notizen während des Codens durchsuchen

Claude Code durchsucht dein Obsidian-Vault per Volltextsuche nach einer alten Architekturentscheidung, während du genau an diesem Modul arbeitest.

Erkenntnisse direkt zurückschreiben

Du lässt Claude nach einer Debugging-Session eine neue Notiz mit Zusammenfassung direkt ins Vault schreiben (vault_write), ohne Obsidian selbst zu öffnen.

⛔ WANN EHER NICHT?

Kein Zugriff aus der Ferne

Der Server läuft nur lokal auf 127.0.0.1 — Obsidian muss mit geöffnetem Vault auf demselben Rechner laufen, sonst ist der Endpunkt nicht erreichbar.

Besser: Für Zugriff von einem anderen Gerät einen eigenen Tunnel/Reverse-Proxy aufsetzen (nicht Teil des Plugins) oder direkt auf dem Rechner mit dem Vault arbeiten.

Claude Desktop braucht Zusatzschritt

Claude Desktop spricht kein natives HTTP-MCP, laut Doku ist dafür ein Proxy wie mcp-remote nötig.

Besser: Claude Code nutzen (natives HTTP-MCP) oder mcp-remote als Brücke konfigurieren.