obsidian-mcp-server

Ein minimales Obsidian-Plugin, das einen MCP-Server (Model Context Protocol) direkt in Obsidian ausführt und dabei den Streamable HTTP transport verwendet. Es stellt vier Werkzeuge bereit: list_notes, read_note, write_note, search_notes.

Läuft vollständig auf deinem Rechner (bindet an 127.0.0.1) — es verlassen keine Daten deinen PC, es sei denn, du verbindest einen Remote-Client damit, was du nicht tun solltest.

Warum dieser Ansatz

Obsidians Desktop-App basiert auf Electron mit für Plugins verfügbarer Node-Integration, sodass das Plugin einen echten http.Server öffnen und direkt MCP sprechen kann — kein externer Prozess, kein separater npx-Server, der weiterlaufen muss.

Related MCP server: obsidian-mcp

Build (Windows)

# 1. Put this folder inside your vault's plugin directory, e.g.:
#    <vault>\.obsidian\plugins\obsidian-mcp-server\

cd <vault>\.obsidian\plugins\obsidian-mcp-server
npm install
npm run build

Dies erzeugt main.js neben manifest.json. Danach in Obsidian: Einstellungen → Community-Plugins → schalte „MCP Server“ ein. Es sollte eine Meldung erscheinen: MCP server listening on http://127.0.0.1:8123/mcp.

Öffne die Plugin-Einstellungen, um den Port zu ändern oder ein Bearer-Token festzulegen.

Claude Desktop verbinden

Die lokale mcpServers-Konfiguration von Claude Desktop erwartet einen stdio-Befehl, keine direkte URL. Überbrücke den HTTP-Endpunkt daher mit mcp-remote (wird bei Bedarf per npx installiert, benötigt Node.js):

Bearbeite %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:8123/mcp"]
    }
  }
}

Falls du in den Plugin-Einstellungen ein Bearer-Token festgelegt hast, übergebe es als Header:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "http://127.0.0.1:8123/mcp",
        "--header", "Authorization:Bearer YOUR_TOKEN"
      ]
    }
  }
}

Beende Claude Desktop über das Tray-Symbol und öffne es erneut. Es sollte ein Werkzeug-Symbol erscheinen, das die vier Obsidian-Werkzeuge anzeigt.

Debugging

• Verwende den MCP Inspector, um den Server direkt zu testen, ohne Claude Desktop: npx @modelcontextprotocol/inspector und verbinde dich mit http://127.0.0.1:8123/mcp.

• Obsidians Entwicklerkonsole (Ctrl+Shift+I) zeigt die console.error-Ausgaben des Plugins, einschließlich Anfragefehler.

Erweitern

Füge in buildMcpServer() in main.ts weitere Werkzeuge hinzu — z. B. kapsle app.metadataCache für Frontmatter-/Tag-Abfragen oder app.workspace für „Welche Notiz ist gerade geöffnet?“. Jedes Werkzeug besteht lediglich aus einem Namen, einem zod-Eingabeschema und einem asynchronen Handler, der { content: [...] } zurückgibt.

Hinweise / Einschränkungen

• isDesktopOnly: true im Manifest — das Plugin wird auf Obsidian Mobile nicht geladen, da es dort kein natives http-Modul gibt.

• Der zustandslose Transportmodus hier (ein neues StreamableHTTPServerTransport pro Anfrage) ist die einfachste Option und für einen einzelnen lokalen Client ausreichend. Falls du mehrere gleichzeitige Clients mit ordnungsgemäßer Sitzungskontinuität möchtest, würdest du eine nach Mcp-Session-Id indizierte Transport-Map hinzufügen — siehe das Beispiel „with session management“ im MCP TypeScript SDK.

• Das Bearer-Token ist eine einfache Shared-Secret-Prüfung, keine echte Authentifizierung. Da der Server nur an 127.0.0.1 bindet, ist das Hauptbedrohungsmodell „andere lokale Prozesse auf deinem Rechner“, gegen die das Token tatsächlich hilft.