Obsidian MCP

Ein MCP-Server (Model Context Protocol), der KI-Assistenten (Claude, Cursor, etc.) Zugriff auf deinen Obsidian-Vault gibt. Navigiere in Ordnern, lies Notizen, erstelle, bearbeite, verschiebe, benenne sie um und lösche sie – alles aus deinem KI-Chat.

Voraussetzungen

• Python 3.10+

• uv (empfohlen) oder pip

• Ein Obsidian-Vault auf deinem lokalen Rechner

Related MCP server: mcp-obsidian

Installation

# Clone the repo
git clone https://github.com/your-username/obsidian-mcp
cd obsidian-mcp

# Copy the env template and set your vault path
cp .env.example .env

Bearbeite .env und setze deinen Vault-Pfad:

OBSIDIAN_VAULT_PATH="/Users/you/Documents/MyVault"

So findest du deinen Vault-Pfad in Obsidian: Einstellungen → Über → Vault-Pfad.

Server ausführen

Entwicklung (mit MCP Inspector UI)

uv run mcp dev server.py

Dadurch wird der MCP Inspector in deinem Browser geöffnet, wo du alle Tools interaktiv testen kannst.

Produktion

uv run server.py

Verbindung zu Cursor herstellen

Füge dies zu deiner .cursor/mcp.json hinzu (oder zu den globalen MCP-Einstellungen von Cursor):

{
  "mcpServers": {
    "obsidian": {
      "command": "python",
      "args": ["/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Ersetze /absolute/path/to/obsidian-mcp/server.py durch den tatsächlichen Pfad zu server.py auf deinem Rechner und /path/to/your/vault durch deinen Vault-Pfad (findest du ihn in Obsidian: Einstellungen → Über → Vault-Pfad).

Verbindung zu Claude Desktop herstellen

Füge dies zu deiner claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["run", "/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Verfügbare Tools

Alle Pfade sind relativ zum Vault-Wurzelverzeichnis, z. B. "Projects/App/roadmap.md".

Lizenz

MIT