Obsidian MCP Server MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Acht Tools für Notizen, Tags, Titel und Suche
Aktualisierungsmodi anhängen/voranstellen/überschreiben – Agenten müssen nicht ganze Dateien neu generieren
Operationen auf Schlüsselebene der atomaren Frontmaterie
Globale Fuzzy-Suche im gesamten Tresor
Caching-Schicht für schnellere wiederholte Lesevorgänge

Live-Demo

In der Praxis

obsidian-mcp-server.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

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

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-server"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Obsidian MCP Server

Erfassen Sie Ideen von jedem MCP-Kunden in der heutigen Tagesnotiz

👤 Obsidian-Benutzer, die im Chat leben ⏱ ~5 min beginner

Wann einsetzen: Sie befinden sich mitten in einem Gespräch mit Claude und möchten einen Gedanken in Ihrem Tresor speichern, ohne die App wechseln zu müssen.

Voraussetzungen

Obsidian mit aktiviertem Local REST API-Plugin — Community-Plugins → „Lokale REST-API“ installieren → API-Schlüssel kopieren
MCP-Client konfiguriert mit OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL — Siehe Konfigurationsblock; Die Basis-URL ist normalerweise http://127.0.0.1:27123

Ablauf

Überprüfen Sie, ob die Tagesnotiz vorhanden ist

Listen Sie die Notizen unter Daily/2026-04-17.md auf.✓ Kopiert

→ Dateipfad bestätigt oder „nicht gefunden“
Hängen Sie die Aufnahme an

Hängen Sie „- Idee: Probieren Sie X für den Caching-Fehler aus“ an Daily/2026-04-17.md an.✓ Kopiert

→ Anhängen bestätigt, ohne vorherige Einträge zu überschreiben

Ergebnis: Ein laufendes Tagebuch, das Agenten ergänzen können, ohne es zu überladen.

Fallstricke

Verwenden Sie den Überschreibmodus, wenn Sie „Anhängen“ meinten — Always default to append or prepend on daily notes; Speichern und für neue Entwürfe überschreiben

Kombinieren mit: filesystem

Verwandeln Sie eine Woche voller Notizen in ein Überprüfungsdokument

👤 Wissensarbeiter führen wöchentliche Überprüfungen durch ⏱ ~20 min intermediate

Wann einsetzen: Sie benötigen eine Freitagssynthese über die verstreuten Notizen der Woche.

Voraussetzungen

Markierte oder datierte Notizen — Verwenden Sie #weekly oder einen Daily/-Ordner

Ablauf

Durchsuchen Sie die Notizen der Woche

Globale Suche: Diese Woche geänderte Notizen unter Täglich/.✓ Kopiert

→ Liste mit 5–7 Dateipfaden
Lesen Sie jeweils

Lesen Sie jede Tagesnotiz und fassen Sie sie thematisch zusammen.✓ Kopiert

→ Thematische Aufzählungszeichen, keine rohe Verkettung
Schreiben Sie die Rezension

Schreiben Sie die Zusammenfassung an Reviews/2026-W16.md; Frontmatter-Status hinzufügen: Rezension, Tags: [wöchentlich].✓ Kopiert

→ Neue Datei mit korrekter Titelseite

Ergebnis: Eine wöchentliche Überprüfungsnotiz, die aus dem Rohmaterial ohne manuelles Kopieren und Einfügen erstellt wurde.

Kombinieren mit: github

Konsolidieren Sie unordentliche Tags in einem Tresor

👤 Tresore, die organisch gewachsen sind und nun die Varianten #Work / #work / #WORK haben ⏱ ~30 min intermediate

Wann einsetzen: Die Tag-Liste ist aufgrund von Duplikaten und Beinahe-Duplikaten zu lang.

Ablauf

Aktuelle Tags auflisten

Verwenden Sie obsidian_manage_tags, um alle Tags nach Verwendung sortiert aufzulisten.✓ Kopiert

→ Tag-Zählungen bringen die Duplikate zum Vorschein
Schlagen Sie eine Zuordnung vor

Schlagen Sie eine kanonische Menge und eine Zuordnung von Alt → Neu vor.✓ Kopiert

→ Kleiner, überprüfbarer Tisch
Bewerben Sie sich stapelweise

Nachdem ich dies bestätigt habe, benennen Sie die Tags im gesamten Tresor mithilfe der Zuordnung um.✓ Kopiert

→ Tag-Vorgänge pro Notiz zusammengefasst

Ergebnis: Saubere Tag-Taxonomie, in der Sie tatsächlich navigieren können.

Fallstricke

Hunderte von Notizen auf einmal ohne Backup neu schreiben — Übertragen Sie den Tresor zuerst auf Git. Überprüfen Sie den Unterschied

Kombinieren mit: git

Legen Sie Webausschnitte in einem Recherche-Posteingang ab und kennzeichnen Sie sie automatisch

👤 Forscher, Analysten, jeder, der eine Clipper-Angewohnheit hat ⏱ ~15 min beginner

Wann einsetzen: Der Posteingang/Ordner stapelt sich schneller, als Sie ihn verarbeiten können.

Voraussetzungen

Ein bestimmter Posteingang/Ordner — Erstellen Sie es im Tresor

Ablauf

Posteingang auflisten

Listen Sie Notizen ohne Tags unter „Posteingang/“ auf.✓ Kopiert

→ Pfade ausstehender Elemente
Klassifizieren und taggen

Schlagen Sie jeweils 1–3 Tags basierend auf dem Inhalt vor und wenden Sie diese dann mit obsidian_manage_tags an.✓ Kopiert

→ Tags werden atomar über Frontmatter hinzugefügt

Ergebnis: Der Posteingang bleibt klein; Neue Clips werden automatisch organisiert.

Kombinieren mit: fetch

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

obsidian-mcp-server + fetch

Schneiden Sie eine URL mit fetch aus und schreiben Sie sie dann in den Posteingang/

Rufen Sie https://... ab und speichern Sie eine bereinigte Zusammenfassung unter Inbox/YYYY-MM-DD-title.md mit der richtigen Frontmatter.✓ Kopiert

obsidian-mcp-server + github

Kopieren Sie zusammengeführte PR-Zusammenfassungen in Projects/<repo>.md

Suchen Sie diese Woche nach zusammengeführten PRs und fügen Sie eine Zusammenfassung unter ## Week 16 in Projects/acme-api.md hinzu.✓ Kopiert

obsidian-mcp-server + git

Versionieren Sie Ihren Tresor und übernehmen Sie Batch-Änderungen

Führen Sie nach der Tag-Bereinigung „git diff“ im Tresor aus und fassen Sie die Daten zusammen, bevor Sie sie festschreiben.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen
obsidian_read_note	path: str	Lesen Sie eine bestimmte Notiz, bevor Sie sie bearbeiten oder zusammenfassen
obsidian_update_note	path: str, content: str, mode: 'append'\|'prepend'\|'overwrite'	Notizinhalt hinzufügen oder ersetzen – standardmäßig anhängen, sofern nicht neu geschrieben
obsidian_search_replace	path: str, find: str, replace: str	Gezielte Bearbeitungen innerhalb der Notiz, ohne die gesamte Datei neu zu generieren
obsidian_global_search	query: str, filters?	Finden Sie Notizen im gesamten Tresor
obsidian_list_notes	folder?: str	Listen Sie Notizen in einem Ordner auf, bevor Sie Batch-Operationen durchführen
obsidian_manage_frontmatter	path: str, op: 'get'\|'set'\|'delete', key?: str, value?: any	Atomare Frontmaterie-Änderungen auf Schlüsselebene
obsidian_manage_tags	path?: str, op: 'list'\|'add'\|'remove'	Markieren Sie Hygiene- und Taxonomievorgänge
obsidian_delete_note	path: str	Entfernen Sie eine Notiz – dauerhaft, kein Rückgängigmachen möglich

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Keine externe API – Die lokale REST-API läuft auf Ihrem Mac/PC
Tokens pro Aufruf: Notengroß; typisch 200–3000
Kosten in €: Frei
Tipp: Bevorzugen Sie global_search + read on Demand, anstatt ganze Ordner im Kontext aufzulisten.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: OBSIDIAN_API_KEY nur in der Umgebungsvariable – nie festgeschrieben. Behandeln Sie es wie ein lokales Administrator-Token für Ihren Tresor.

Datenabfluss: Der gesamte Datenverkehr erfolgt über localhost → Obsidian Local REST API. Keine Cloud-Aufrufe von diesem Server.

Das Local REST API-Plugin stellt Ihren Tresor auf einem lokalen HTTP-Port bereit; Binden Sie sich nur an 127.0.0.1 und lassen Sie HTTPS nur für localhost ausgeschaltet.
Ein Angreifer, der Ihren OBSIDIAN_API_KEY erreicht, erhält vollständige Lese-/Schreibzugriff auf den Tresor – rotieren Sie, wenn Sie eine Leckage vermuten.

Fehlerbehebung

Häufige Fehler und Lösungen

ECONNREFUSED 127.0.0.1:27123

Obsidian wird nicht ausgeführt oder das Local REST API-Plugin ist deaktiviert. Öffnen Sie Obsidian und aktivieren Sie das Plugin.

Prüfen: curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/

401 Nicht autorisiert

OBSIDIAN_API_KEY stimmt nicht mit dem aktuellen Schlüssel des Plugins überein. Kopieren Sie den Wert erneut aus den Plugin-Einstellungen.

Prüfen: Plugin Settings → Local REST API → copy the API key

404 in einer bekannten Datei

Der Pfad ist Tresor-bezogen und unterscheidet zwischen Groß- und Kleinschreibung – bestätigen Sie dies mit obsidian_list_notes.

Prüfen: obsidian_list_notes folder='Daily'

Alternativen

Obsidian MCP Server vs. andere

Alternative	Wann stattdessen	Kompromiss
obsidian-plugin-skill	Sie möchten, dass Claude beim Erstellen von Obsidian-Plugins hilft und nicht beim Bearbeiten von Tresorinhalten	Unterschiedlicher Umfang
filesystem MCP	Sie kommen mit rohen Dateioperationen zurecht und benötigen keine Obsidian-fähigen Frontmatter/Tag-APIs	Sie verlieren atomare Tag-/Frontmatter-Operationen

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen