/ Verzeichnis / Playground / Obsidian MCP Tools
● Community jacksteamdev ⚡ Sofort

Obsidian MCP Tools

von jacksteamdev · jacksteamdev/obsidian-mcp-tools

Eine echte MCP-Oberfläche für dein Obsidian-Vault hinzufügen — semantische Suche via Smart Connections, Templater-Prompts, vollständiges File-CRUD — ohne den Editor zu verlassen.

Obsidian MCP Tools wird als Community-Plugin und MCP-Bridge geliefert, damit Claude dein Vault semantisch durchsuchen kann (via Smart Connections), Templater-Templates mit Prompts ausführen und Notizen erstellen, lesen und aktualisieren kann. Lokal-first — keine SaaS-Uploads deiner Notizen — und integriert sich in das Obsidian-Community-Plugin-Ökosystem, das du wahrscheinlich bereits nutzt.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

obsidian-mcp-tools.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-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

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

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

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

Anwendungsfälle

Praxisnahe Nutzung: Obsidian MCP Tools

So fragst du dein Second Brain ab, statt es zu durchsuchen

👤 Obsidian-PKM-Nutzer mit 1.000+ Notizen ⏱ ~20 min intermediate

Wann einsetzen: Du weißt, dass du vor Monaten etwas geschrieben hast, aber die Stichwortsuche findet es nicht.

Voraussetzungen
  • Obsidian + dieses Plugin + Smart-Connections-Plugin — Beide aus den Community-Plugins installieren; Smart Connections indexiert beim ersten Start
Ablauf
  1. Index prüfen
    Verify Smart Connections has finished embedding my vault. Report total notes indexed.✓ Kopiert
    → Anzahl indexierter Notizen; verwendetes Embedding-Modell
  2. Semantische Suche
    Find notes related to 'why I left my last job' even if those exact words aren't in any note.✓ Kopiert
    → 5 Notizen nach semantischer Übereinstimmung gerankt, mit Auszügen
  3. Zusammenfassen
    Synthesize those into a short reflection note. Save under /Reflections/ with a wikilink to each source.✓ Kopiert
    → Neue Notiz erstellt; Backlinks aufgelöst

Ergebnis: Ein Second Brain, das auf Konzepte antwortet, nicht auf Stichwörter.

Fallstricke
  • Semantische Suche findet sensible persönliche Notizen — Obsidians excludedFolders-Einstellung in Smart Connections nutzen, um private Verzeichnisse zu überspringen
Kombinieren mit: humanizer-skill

Ein Templater-Template von Claude aus mit automatisch ausgefüllten Prompts ausführen

👤 Power-Obsidian-Nutzer mit Templates ⏱ ~10 min intermediate

Wann einsetzen: Du hast ein ‚Projekt-Kickoff'-Templater-Template mit 5 Prompts; lieber soll Claude es orchestrieren.

Voraussetzungen
  • Templater mit eingerichteten Templates installiert — Standard-Community-Plugin
Ablauf
  1. Templates auflisten
    What Templater templates are available?✓ Kopiert
    → Template-Liste mit Prompt-Beschreibungen
  2. Mit automatischer Ausfüllung ausführen
    Run 'project_kickoff' for a project called 'Q3 onboarding overhaul'. Auto-answer the prompts based on context.✓ Kopiert
    → Neue Notiz per Template erstellt; Prompts ausgefüllt

Ergebnis: Templates per Chat starten statt über ein Modal.

Fallstricke
  • Manche Templater-Befehle sind asynchron und benötigen Zeit — MCP-Tool wartet auf den Abschluss — aber nicht zu viele in einem Aufruf verketten

Eine Tagesnotiz automatisch aus dem gestrigen Kalender und offenen Aufgaben erstellen

👤 Produktivitätsorientierte Obsidian-Nutzer ⏱ ~15 min intermediate

Wann einsetzen: Du bearbeitest jeden Tag dasselbe ‚Daily'-Template — automatisiere es.

Ablauf
  1. Heutige Daten abrufen
    Read yesterday's daily note. Carry forward incomplete tasks. Pull today's calendar via google-calendar MCP.✓ Kopiert
    → Übertragene Aufgaben + heutige Termine ermittelt
  2. Tagesnotiz schreiben
    Create today's daily note in /Daily/$(date +%F).md with the standard sections.✓ Kopiert
    → Notiz erstellt und geöffnet

Ergebnis: Tagesnotiz in 5 Sekunden bereit.

Fallstricke
  • Beim Übertragen werden Aufgaben dupliziert, wenn dieselbe Aufgabe in 2 Tagen steht — Vor dem Schreiben nach Zeilentext deduplizieren
Kombinieren mit: google-calendar

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

obsidian-mcp-tools + google-calendar

Tagesnotizen erstellen, die die Termine des Tages enthalten

obsidian-mcp-tools + github

Ein Projektboard in einer Vault-Notiz spiegeln

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
search_semantic query, k? Konzeptbasierter Abruf 1 Smart-Connections-Abfrage
read_note path Eine einzelne Notiz abrufen kostenlos
write_note path, content, mode: 'create'|'append'|'overwrite' Eine Notiz erstellen oder aktualisieren kostenlos
list_templates (keine) Ausführbare Templates entdecken kostenlos
run_templater template_name, prompt_answers: {} Einen Template-Workflow ausführen kostenlos

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
Lokal — abhängig vom Smart-Connections-Embedding-Dienst, sofern Cloud-basiert
Tokens pro Aufruf
100–1500 pro Notiz
Kosten in €
Kostenlos (das Plugin); Smart Connections hat kostenlose lokale und kostenpflichtige Cloud-Optionen
Tipp
Die lokale Embedding-Option in Smart Connections verwenden, um Kosten pro Abfrage zu vermeiden

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Nur lokales Plugin; keine Remote-Speicherung
Datenabfluss: Lokal — außer wenn Smart Connections für Cloud-Embeddings konfiguriert ist

Fehlerbehebung

Häufige Fehler und Lösungen

MCP-Tools erscheinen nicht

Bestätigen, dass das Obsidian-Plugin aktiviert ist und der MCP-Bridge-Prozess läuft

Prüfen: Plugin-Statusleiste prüfen; Obsidian neu starten
search_semantic gibt nichts zurück

Smart-Connections-Indexierungsjob ist möglicherweise noch nicht abgeschlossen — Fortschritt prüfen

Prüfen: Smart-Connections-Seitenleiste öffnen
write_note schlägt fehl mit ‚Pfad außerhalb des Vaults'

Pfade sind relativ zum Vault-Stammverzeichnis; keine absoluten Pfade verwenden

Alternativen

Obsidian MCP Tools vs. andere

AlternativeWann stattdessenKompromiss
ergut/mcp-logseqDu nutzt Logseq statt ObsidianAnderes Ökosystem; gleiche Idee
AgriciDaniel/claude-obsidian (Skill)Du möchtest einen skill-förmigen Workflow auf Basis von File-IODer Skill ist übergeordnet; dieses MCP sind die Bausteine

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen