obsidian-mcp

Ein MCP-Server, der jedes Obsidian-Vault in einen KI-abfragbaren Wissensgraphen verwandelt.

Was diesen von den 24+ bestehenden Obsidian-MCP-Servern unterscheidet:

• Graph-orientiert — BFS, kürzester Pfad, zusammenhängende Komponenten, Brückenerkennung über [[wikilinks]]

• Null-Infrastruktur — Keine Datenbank, kein laufendes Obsidian, keine API-Schlüssel

• Vault-agnostisch — Funktioniert mit jedem bestehenden Vault, keine erforderliche Struktur

• Backlink-bewusste Schreiboperationen — move_note aktualisiert automatisch alle Referenzen im gesamten Vault

• Winzig — 4 Laufzeitabhängigkeiten, ~42KB Bundle

Schnellstart

npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

Füge Folgendes zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]
    }
  }
}

Claude Code

claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

Related MCP server: some-vault-some-mcp

Tools (12)

Lesen & Entdecken

Graph-Traversierung

Schreiben & Manipulation

Konfiguration

Standardmäßig ohne Konfiguration. Optionale .obsidian-mcp.json im Vault-Stammverzeichnis:

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}

CLI-Flags

--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

So funktioniert's

1. Beim Start werden alle .md-Dateien gescannt und ein In-Memory-Graph erstellt (~1-3s für 1k Notizen)

2. Ein File-Watcher erkennt Änderungen und aktualisiert den Graphen inkrementell (~5ms pro Änderung)

3. Claude fragt den Graphen über MCP-Tools ab — kein erneutes Scannen nötig

4. Schreiboperationen aktualisieren sowohl das Dateisystem als auch den Graphen atomar

Hartkodierte Ausschlüsse: .obsidian/, .trash/, node_modules/

Entwicklung

npm install
npm test              # Run 66 tests
npm run build         # Build to dist/
npm run dev -- --vault test/fixtures/vault  # Dev mode

Lizenz

MIT