Skip to main content
Glama
Obsidian MCP Local

Obsidian MCP Local

Obsidian MCP Local

Lokaler MCP in Node.js + TypeScript, um Ihren Obsidian-Vault für VS Code + GitHub Copilot verfügbar zu machen.

Er wurde für die lokale Nutzung via stdio entwickelt, mit Fokus auf das Lesen und Schreiben von Markdown-Notizen innerhalb Ihres Vaults.

Install

npm install -g obsidian-mcp-local

Related MCP server: Obsidian MCP Server

Features

Verfügbare Tools

  • search_notes(query)

    • sucht nach Text im Pfad, Frontmatter und Inhalt der Notizen

    • gibt gerankte Ergebnisse mit einem kurzen Ausschnitt zurück

  • get_note(path)

    • öffnet eine Notiz aus dem Vault

    • gibt path, frontmatter und content zurück

  • create_note(path, content, overwrite?)

    • erstellt eine neue Notiz

    • überschreibt optional eine bestehende Notiz

  • append_to_note(path, content)

    • fügt Inhalt am Ende einer bestehenden Notiz hinzu

  • find_by_tag(tag)

    • findet Notizen nach Tag

    • unterstützt tags im Frontmatter und Inline-Tags im Inhalt

Implementierte Regeln

  • greift nur auf Dateien innerhalb des konfigurierten Vaults zu

  • ignoriert Verzeichnisse wie:

    • .obsidian

    • .git

    • node_modules

  • arbeitet nur mit .md-Dateien

  • normalisiert Pfade, um Zugriffe außerhalb des Basisverzeichnisses zu verhindern

Projektstruktur

obsidian-mcp-local/
  package.json
  tsconfig.json
  README.md
  .vscode/
    mcp.example.json
  src/
    index.ts

Voraussetzungen

  • Node.js 20+

  • npm

  • VS Code mit GitHub Copilot

  • ein lokaler Obsidian-Vault

Installation

Im Projektverzeichnis:

npm install
npm run build

Für die Entwicklung:

npm run dev

Um die kompilierte Version auszuführen:

npm start

Verwendung in VS Code

1. Projekt kompilieren

npm install
npm run build

2. MCP-Datei von VS Code anpassen

Kopieren Sie den Inhalt von .vscode/mcp.example.json in Ihre .vscode/mcp.json im Workspace, in dem Sie Copilot verwenden möchten.

Beispiel: bei lokaler Nutzung:

{
  "servers": {
    "obsidian-local-vault": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/caminho/para/obsidian-mcp-local/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

bei Nutzung via npx (kein lokaler Build erforderlich):

{
  "servers": {
    "obsidian-local-vault": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp-local"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

3. Pfade aktualisieren

Ersetzen Sie:

  • C:/caminho/para/obsidian-mcp-local/dist/index.js

  • D:/Obsidian/Vault

durch die tatsächlichen Pfade auf Ihrem Rechner.

4. VS Code neu starten/neu laden

Danach sollte Copilot den MCP-Server erkennen.

Anwendungsbeispiele im Copilot Chat

  • „Suche in meinem Vault nach Notizen über .NET“

  • „Öffne die Notiz knowledge/backend/dotnet.md“

  • „Erstelle eine Notiz in inbox/ideias-mcp.md mit einer Zusammenfassung dessen, was wir besprochen haben“

  • „Füge am Ende der Notiz daily/2026-04-06.md den Text - testar MCP local hinzu“

  • „Finde Notizen mit dem Tag #arquitetura“

Mögliche zukünftige Verbesserungen

  • append_under_heading

  • Parsing von [[wikilinks]]

  • get_backlinks(note)

  • SQLite-Index für schnelle Suche

  • Whitelist von Ordnern für Schreibzugriffe (inbox/, daily/, scratch/)

  • konfigurierbare Schreibsperre für bestimmte Ordner

Wichtige Hinweise

  • Dieses Projekt hängt nicht davon ab, dass Obsidian geöffnet ist.

  • Es arbeitet direkt auf den Dateien des Vaults.

  • Wenn Sie Schreibzugriffe sowohl in Obsidian als auch in VS Code aktivieren, liegt die Kontrolle über die Nebenläufigkeit bei Ihnen.

  • Das Projekt geht derzeit davon aus, dass der Vault ein lokaler Markdown-Ordner ist.

Hauptdatei

Die Implementierung befindet sich in:

  • src/index.ts

Lizenz

Persönliche Nutzung / Basis für Anpassungen.

Available Tools

5 tools
append_to_noteD

Inputs: path (required), content (required).

create_noteD

Inputs: path (required), content (required), overwrite.

find_by_tagD

Inputs: tag (required).

get_noteD

Inputs: path (required).

search_notesD

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool name clearly indicates a distinct operation: create, get, append, search, and find by tag. No significant overlap is apparent.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_note, search_notes), making the set predictable.

    Tool Count5/5

    Five tools cover essential note operations (create, retrieve, modify, search, tag) without unnecessary bloat or deficiency for the domain.

    Completeness3/5

    The set includes create, read, update (via append), and search operations but lacks a delete operation, which is a notable gap for a complete CRUD surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables direct file system access to Obsidian vaults with auto-discovery, full-text search, and note operations. Supports reading, writing, and searching across Obsidian notes without requiring plugins or REST API.
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Obsidian vaults through direct filesystem access, supporting note management, lightning-fast search with SQLite indexing, image analysis, tag/link management, and bulk operations.
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to read, write, search, and navigate Obsidian vault notes with support for CRUD operations, full-text search, graph navigation, daily notes, and frontmatter management.
      3,713 npm
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with local Obsidian vaults through direct filesystem access for reading, creating, and managing notes. It features high-performance SQLite indexing for fast searches, regex support, and tools for organizing tags and links without requiring additional plugins.
      27
      1
      MIT