Obsidian Vault MCP (kostenlos, keine Karte, kein ständig laufender Computer nötig)

Dies gibt Claude (mobil, Desktop, Web) Lesezugriff auf deinen Obsidian-Vault über einen kleinen Server, der kostenlos auf Render gehostet wird und direkt aus einem GitHub-Repo liest. Dein Vault wird über das Obsidian Git Plugin von deinem Telefon und Desktop aus mit GitHub synchronisiert – nichts muss eingeschaltet bleiben.

Bestandteile

• GitHub-Repo – die Quelle der Wahrheit für den Vault (kostenlos, privat).

• Obsidian Git Plugin – führt automatisch Commits/Pushes/Pulls von Desktop + Telefon durch.

• Dieser MCP-Server – liest das Repo über die GitHub-API, stellt list_notes, read_note, search_notes über MCP bereit. Kostenlos auf Render bereitgestellt.

• Graphify – optional, lokal ausführen, dessen Ausgabe wie jede andere Notiz in das Repo committen.

Related MCP server: Obsidian MCP Server

1. Das GitHub-Repo erstellen

1. github.com → Neues Repository → Name z.B. obsidian-vault → Privat → Erstellen.

2. Einstellungen → Entwicklereinstellungen → Persönliche Zugriffstoken → Feingranuliertes Token:

   • Repository-Zugriff: nur dieses Repo.

   • Berechtigungen: Inhalte → Lesen und Schreiben (damit Claude Notizen erstellen und bearbeiten kann, nicht nur lesen).

   • Kopiere das Token – du wirst es später in Render als GITHUB_TOKEN einfügen.

2. Obsidian Git einrichten (Desktop + Telefon)

1. Obsidian → Einstellungen → Community-Plugins → Durchsuchen → Obsidian Git installieren.

2. Richte deinen Vault-Ordner auf einen lokalen Klon des Repos (oder git init an Ort und Stelle und füge das GitHub-Repo als origin hinzu).

3. Aktiviere in den Plugin-Einstellungen automatisches Backup in Intervallen (z.B. alle 10 Minuten) und automatisches Pull beim Laden – es wird für dich committen, pushen und pullen.

4. Auf dem Telefon: Installiere Obsidian mobil, füge dasselbe Plugin hinzu (es funktioniert auf iOS/Android), melde dich im Authentifizierungsbildschirm des Plugins bei GitHub an.

Jetzt pusht/pullt jedes Gerät in dasselbe Repo – dieses Repo ist deine Synchronisationsebene.

3. Den MCP-Server auf Render bereitstellen (kostenlos)

1. Verschiebe diesen Ordner (server.js, package.json, render.yaml) in ein eigenes öffentliches oder privates GitHub-Repo (getrennt vom Vault-Repo).

2. render.com → Neu → Web Service → verbinde dieses Repo.

3. Es sollte render.yaml automatisch erkennen. Falls nicht: Build-Befehl npm install, Start-Befehl npm start, Plan Free.

4. Füge Umgebungsvariablen hinzu:

   • GITHUB_TOKEN – das feingranulierte Token aus Schritt 1

   • GITHUB_OWNER – dein GitHub-Benutzername

   • GITHUB_REPO – der Name deines Vault-Repos (z.B. obsidian-vault)

   • GITHUB_BRANCH – main (oder welcher Standard-Branch auch immer)

   • MCP_SHARED_SECRET – erfinde eine zufällige Zeichenfolge; das verhindert, dass Fremde, die deine Render-URL finden, deinen Vault lesen

5. Bereitstellen. Du erhältst eine URL wie https://obsidian-vault-mcp.onrender.com.

Hinweis zum kostenlosen Tarif: Er schläft nach ca. 15 Minuten Inaktivität ein und braucht ein paar Sekunden, um bei der nächsten Anfrage aufzuwachen – für gelegentliche Claude-Abfragen in Ordnung.

4. Mit Claude verbinden

In Claude → Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen:

• URL: https://<deine-app>.onrender.com/mcp

• Header: Authorization: Bearer <dein MCP_SHARED_SECRET>

Dann bitte Claude einfach, deine Notizen zu durchsuchen, zu lesen oder zu bearbeiten – es wird automatisch search_notes / read_note / list_notes / write_note / delete_note aufrufen. Schreibvorgänge werden direkt in das Repo committet, sodass sie auf deinem Telefon/Desktop beim nächsten Sync von Obsidian Git erscheinen (oder sofort, wenn du automatisches Pull-on-Interval aktiviert hast).

Hinweis zu Schreibvorgängen: write_note überschreibt die gesamte Datei – für Bearbeitungen einer vorhandenen Notiz solltest du Claude bitten, sie zuerst zu lesen und dann den vollständig aktualisierten Inhalt zurückzuschreiben. delete_note ist ein echter, dauerhafter Git-Commit; es ist sinnvoll, Claude zu bitten, vor dem Löschen eine Bestätigung von dir einzuholen.

5. Graphify – automatisch, kostenlos, kein Hosting nötig

Graphify erstellt einen Wissensgraphen aus deinen Notizen. Für die semantische Extraktion wird ein LLM benötigt, und die kostenlose Option, die kein Hosting erfordert, ist der kostenlose Gemini-API-Tarif von Google (keine Kreditkarte, läuft nicht ab).

Einen kostenlosen Gemini-Schlüssel erhalten:

1. Gehe zu aistudio.google.com, melde dich mit einem Google-Konto an.

2. API-Schlüssel abrufen → API-Schlüssel erstellen. Kopiere ihn.

Den GitHub Actions-Workflow hinzufügen:

1. Erstelle in deinem Vault-Repo .github/workflows/graphify.yml mit dem Inhalt aus der Datei vault-workflow/.github/workflows/graphify.yml dieses Projekts.

2. Repo → Einstellungen → Geheimnisse und Variablen → Aktionen → Neues Repository-Geheimnis:

   • Name: GEMINI_API_KEY

   • Wert: der Schlüssel von AI Studio

3. Repo → Einstellungen → Aktionen → Allgemein → Workflow-Berechtigungen → auf Lese- und Schreibberechtigungen setzen (damit der Workflow den Graphen zurückschreiben kann).

4. Er wird automatisch einmal täglich ausgeführt, und auch immer dann, wenn du eine Änderung an den Vault pushst. Du kannst ihn auch manuell über den Reiter Aktionen des Repos auslösen.

Dies erzeugt graphify-out/graph.json und graphify-out/GRAPH_REPORT.md in deinem Vault-Repo – kein Server, kein Space, nichts, was am Laufen gehalten werden muss.

Der MCP-Server hat bereits Werkzeuge dafür (graph_overview, graph_find_node, graph_neighbors) – sie lesen den Graphen direkt von GitHub, genauso wie read_note es tut. Nichts zusätzlich bereitzustellen; stelle einfach die aktualisierte server.js auf Render bereit, und sie erscheinen beim nächsten Verbinden von Claude.

Lokaler Test (optional, vor der Bereitstellung)

npm install
GITHUB_TOKEN=xxx GITHUB_OWNER=you GITHUB_REPO=obsidian-vault npm start

Dann sende eine POST-Anfrage an http://localhost:3000/mcp mit einem MCP-Client, oder stelle direkt auf Render bereit und teste über Claude.