Obsidien CLI MCP Server

Obsidian CLI MCP Server

Datenschutz-Warnung: Alle Notizen, die ueber diesen MCP-Server abgefragt werden, landen im Kontext des verwendeten LLM. Bei Cloud-LLMs (ChatGPT, Claude, Gemini etc.) bedeutet das: Deine Notizen koennten fuer das Training verwendet werden und waeren nach der Trainingsphase potenziell fuer alle Nutzer abrufbar. Verwende ein lokales LLM (z.B. Ollama, LM Studio), wenn deine Notizen vertrauliche oder persoenliche Inhalte enthalten — es sei denn, es ist dir egal, dass die ganze Welt deine Notizen kennt.

Ein MCP-Server der alle Vault-Operationen an die offizielle Obsidian CLI (v1.12+) delegiert und 32 Tools, MCP Resources sowie 4 MCP Prompts bereitstellt. Kein eigener Index, keine Datenbank — der Server kommuniziert direkt mit einer laufenden Obsidian-Instanz.

Alle Tool-Ausgaben mit Notiz-Pfaden enthalten sowohl einen klickbaren obsidian://-Link als auch den rohen Vault-Pfad in Backticks — AI-Agenten koennen letzteren direkt in read_note weiterverwenden ohne URL-Dekodierung. Alle Tool-Aufrufe werden in mcp-requests.log protokolliert.

Voraussetzungen

Wichtig: Die CLI verbindet sich zur laufenden Obsidian-App. Ohne gestartetes Obsidian geben alle Tools Fehler zurueck. Der Server startet trotzdem und loggt eine Warnung.

Installation

git clone https://github.com/FinPark/Obsidien-CLI-MCP-Server.git
cd Obsidien-CLI-MCP-Server
npm install
npm run build

Konfiguration

Alle Einstellungen sind optional und ueber Umgebungsvariablen steuerbar (oder via .env-Datei):

Server starten

npm start

Ausgabe bei erfolgreichem Start:

[obsidian-mcp] Connected to Obsidian 1.12.7
[obsidian-mcp] StreamableHTTP server running on http://localhost:8201/mcp

MCP Tools (32)

Suche & Lesen

Notiz-Management

Ordner

Teilnehmer & Tags

Tasks

Link-Analyse

Properties (Frontmatter)

Outline

Recherche

MCP Resources

Alle Markdown-Notizen des Vaults sind als MCP Resources unter dem Schema obsidian://note/{vault-relativer-pfad} erreichbar. Kompatible MCP-Clients koennen damit direkt auf einzelne Notizen zugreifen ohne explizite Tool-Aufrufe.

MCP Prompts (4)

Vordefinierte Prompts fuer haeufige Aufgaben — werden von kompatiblen MCP-Clients direkt als Slash-Commands oder Prompt-Picker angeboten:

Request-Logging

Alle Tool-Aufrufe werden in mcp-requests.log im Projektverzeichnis protokolliert (zusaetzlich zu stderr). Format:

2026-03-30T10:15:00.000Z [CALL] tool=search_notes args={"query":"Solarertrag"}
2026-03-30T10:15:00.123Z [OK]   tool=search_notes → 342 chars
2026-03-30T10:15:01.000Z [ERROR] tool=read_note → File "foo.md" not found

Die Logdatei wird nicht rotiert — bei Bedarf manuell loeschen oder tail -f mcp-requests.log zum Live-Monitoring verwenden.

Architektur

HTTP Request (Port 8201)
    |
    v
StreamableHTTP Transport (Session-Management)
    |
    v
MCP Server (32 Tools registriert)
    |
    v
CLI Executor (src/cli/obsidian-cli.ts)
    |
    v
/Applications/Obsidian.app/Contents/MacOS/Obsidian
    |
    v
Laufende Obsidian-Instanz

Der CLI-Executor:

• Fuehrt Befehle per execFile aus (kein Shell, sicher gegen Injection)
• Filtert Startup-Noise aus stdout (Loading-Messages, Installer-Warnungen)
• Stripped => Prefix bei eval-Befehlen
• 30 Sekunden Timeout pro Befehl
• 10 MB Buffer fuer grosse Ausgaben

Projektstruktur

src/
  index.ts              HTTP-Server, Session-Management
  server.ts             MCP-Server, Tool-Routing (v2.0.0, 31 Tools + Resources + Prompts)
  config.ts             VAULT_NAME, OBSIDIAN_BIN
  cli/
    obsidian-cli.ts     CLI-Wrapper: exec(), execJson(), Noise-Filtering
  resources/
    notes.ts            MCP Resources Handler — alle Markdown-Notes als obsidian://note/{path} URIs
  prompts/
    index.ts            4 MCP Prompts (meeting-summary, research-topic, daily-review, link-suggestions)
  tools/
    search-notes.ts     search_notes
    read-note.ts        read_note
    list-participants.ts
    list-tags.ts
    vault-stats.ts
    create-note.ts      mit Elicitation-Formular
    move-note.ts        mit Smart-Matching und Elicitation
    list-folders.ts
    manage-tags.ts      update_tags, rename_tag, delete_tag
    tasks.ts            list_tasks, toggle_task
    links.ts            list_backlinks, list_links, list_orphans, list_deadends, list_unresolved
    properties.ts       list_properties, get_property, set_property, remove_property
    outline.ts          get_outline
    note-management.ts  append_note, prepend_note, rename_note, delete_note, file_info, list_files, list_recents, list_modified_notes
    research-chain.ts   research_chain (Vorgaenger-Kette mit Links/Backlinks + Progress Notifications)
    elicitation.ts      tryElicit() Helper

Auto-Start mit launchd (macOS)

~/Library/LaunchAgents/com.obsidian-mcp.plist:

  Label
  com.obsidian-mcp
  ProgramArguments
  
    /usr/local/bin/node
    /path/to/Obsidien-CLI-MCP-Server/dist/index.js
  
  RunAtLoad
  
  KeepAlive
  
  StandardErrorPath
  /tmp/obsidian-mcp.log

launchctl load ~/Library/LaunchAgents/com.obsidian-mcp.plist

Dependencies

Keine weiteren Runtime-Dependencies. Alles laeuft ueber die Obsidian CLI.

Troubleshooting