Obsidian
MCP-Server von Markus Pfundstein
Notizen in einem Obsidian-Vault über das Plugin Local REST API lesen, durchsuchen und bearbeiten.
Obsidian installieren
Läuft auf deinem Rechner. Dein Client startet ihn mit diesem Befehl:
Braucht uv (Python) auf deinem Rechner. Die Schritte unten zeigen, wo der Befehl in jedem Client hingehört.
OBSIDIAN_API_KEYgeheim API key of the Obsidian Local REST API plugin.
Diesen Server teilen
Öffnet diese Seite mit dem Installationsbefehl und den Einrichtungsschritten.
mcp.tc/i/obsidianÜber den Server
Verbindet einen Assistenten über das Community-Plugin Obsidian Local REST API mit einem Obsidian-Vault. Er kann Dateien und Ordner auflisten, Notizinhalte lesen, den Vault durchsuchen, Inhalte an Notizen anhängen oder darin ändern und Dateien löschen.
Er läuft lokal über stdio mit uvx mcp-obsidian und benötigt Python 3.11 oder neuer. Das Plugin Local REST API muss in Obsidian installiert und aktiviert sein, und der Server braucht den API-Schlüssel des Plugins in OBSIDIAN_API_KEY. Host und Port sind optional und lauten standardmäßig 127.0.0.1 und 27124.
Was du damit machen kannst
- Dateien und Verzeichnisse im Vault auflisten
- Inhalt einer Notiz lesen
- Text in allen Vault-Dateien suchen
- Inhalte an neue oder bestehende Notizen anhängen
- Inhalte relativ zu einer Überschrift, einem Block oder einem Frontmatter-Feld einfügen
- Dateien oder Verzeichnisse aus dem Vault löschen
Tools
Obsidian zeigt seine Tools nur Clients mit Schlüssel, deshalb können wir sie hier nicht auflisten.
Beispiel-Prompts
Hol den Inhalt meiner letzten Notiz zum Architektur-Call und fasse ihn zusammen
Durchsuche meinen Vault nach Notizen, die Azure CosmosDB erwähnen
Fasse die letzten Besprechungsnotizen in einer neuen Notiz namens summary meeting.md zusammen
Hänge eine To-do-Liste an meine Notiz zum Projektplan an
Einrichtung
Jeder Client startet Obsidian mit demselben Befehl auf deinem Rechner. Wähl deinen; die Seite merkt sich deine Wahl.
Claude Code
- Führe das in einem Terminal in deinem Projektordner aus:
claude mcp add --transport stdio obsidian --env "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" -- uvx mcp-obsidian- Starte Claude Code und tippe
/mcp. obsidian sollte als verbunden angezeigt werden.
Ergänze --scope user, damit er in jedem Projekt verfügbar ist. Ersetze die Platzhalter durch deine eigenen Werte.
Claude Desktop
- Öffne Settings → Developer → Edit Config. Das öffnet
claude_desktop_config.json. Füge hinzu:
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}- Speichere die Datei und starte Claude Desktop neu. Ersetze die Platzhalter durch deine eigenen Werte.
Braucht uv (Python) auf deinem Rechner. Die Datei liegt unter macOS in ~/Library/Application Support/Claude/ und unter Windows in %APPDATA%\Claude\.
Cursor
Zu Cursor hinzufügen (öffnet in einem neuen Tab)
Oder trag ihn von Hand in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (dieses Projekt) ein:
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}Braucht uv (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
VS Code
Füge ihn zu .vscode/mcp.json hinzu. VS Code fragt beim ersten Mal nach dem Secret und speichert es sicher:
{
"servers": {
"obsidian": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "${input:obsidian-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "obsidian-api-key",
"description": "OBSIDIAN_API_KEY",
"password": true
}
]
}Braucht uv (Python) auf deinem Rechner.
Devin Desktop
- Füge ihn zu
~/.config/devin/mcp_config.json(macOS und Linux) oder%APPDATA%\devin\mcp_config.json(Windows) hinzu:
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}- Aktualisiere die Liste der MCP-Server in Cascade. Ersetze die Platzhalter durch deine eigenen Werte.
Devin Desktop ist der neue Name von Windsurf.
Codex
codex mcp add obsidian --env "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" -- uvx mcp-obsidianOder bearbeite ~/.codex/config.toml direkt:
[mcp_servers.obsidian]
command = "uvx"
args = ["mcp-obsidian"]
env = { OBSIDIAN_API_KEY = "<YOUR_OBSIDIAN_API_KEY>" }Braucht uv (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
Gemini CLI
gemini mcp add -e "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" obsidian uvx mcp-obsidianDamit fügst du ihn dem aktuellen Projekt hinzu. Ergänze -s user, um ihn überall zu nutzen.
Jeder Client
Die meisten Clients, die lokale Server starten, akzeptieren diese Form:
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
}
}
}
}Zed legt Server in seinen Einstellungen unter context_servers ab, mit denselben Feldern command, args und env.
Braucht uv (Python) auf deinem Rechner. Ersetze die Platzhalter durch deine eigenen Werte.
Einbinden
Zeig Obsidian in einem README oder auf deiner Website. Jede Einbindung verlinkt auf diese Seite, nutzt den Installationsbefehl des Servers und setzt keine Cookies. So funktionieren Einbindungen
Karte, iframe und JSON sind auf Englisch. Häng ?lang=it, fr, de oder es an ihre Adresse an, um eine andere Sprache zu bekommen.
README-Badge
[](https://mcp.tc/i/obsidian)<a href="https://mcp.tc/i/obsidian"><img src="https://mcp.tc/i/obsidian/badge.svg" alt="Obsidian on mcp.tc" height="20"></a>Es folgt dem hellen oder dunklen Modus der Lesenden. Hänge ?theme=light oder ?theme=dark an, um ihn festzulegen, oder ?style=compact, um das Zeichen ohne Schriftzug zu zeigen.
Website-Karte
<script src="https://mcp.tc/w/obsidian.js" async></script>Die Karte erscheint dort, wo das Tag steht. Füge dem Tag data-theme="dark" oder data-size="compact" hinzu, um sie zu ändern. Die Datei enthält alles, was sie braucht, stellt also keine weiteren Anfragen und setzt keine Cookies.
iframe
<iframe src="https://mcp.tc/embed/obsidian" title="Obsidian on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Nutze es auf Seiten, die keine Skripte erlauben. Hänge ?theme=light oder ?theme=dark an die Adresse an, um die Farben festzulegen.
JSON
Der Eintrag als Daten für deine eigenen Seiten und Tools: Name, Kurzbeschreibung, Installationsbefehl, Tools und die „Add to“-Links. Jede Website kann ihn lesen (CORS ist offen).
https://mcp.tc/i/obsidian.jsonKI-Prompt
Füg ihn in einen KI-Coding-Assistenten wie Claude Code oder Cursor ein, und er baut die Karte von Obsidian in deine Website ein.
Füge meiner Website die mcp.tc-Karte für den MCP-Server Obsidian hinzu. Es ist ein einziges statisches Skript: kein Build-Schritt, kein Paket zu installieren, keine Cookies.
Setz dieses Tag dorthin, wo die Karte erscheinen soll. Die Karte erscheint direkt davor:
```html
<script src="https://mcp.tc/w/obsidian.js" async></script>
```
Um sie woanders zu zeigen, setz dort diesen Platzhalter ein und lade dasselbe Skript nur einmal, zum Beispiel vor `</body>`. Lass den Link darin stehen: Besucher ohne JavaScript sehen ihn.
```html
<div data-mcptc="obsidian"><a href="https://mcp.tc/i/obsidian">Obsidian on mcp.tc</a></div>
```
Optionen:
- `data-theme="light"` oder `"dark"` am Tag oder Platzhalter legt die Farben fest. Ohne das Attribut folgt die Karte dem hellen oder dunklen Modus der Besucher.
- `data-size="compact"` ergibt eine kleinere Karte ohne Kurzbeschreibung.
- Die CSS-Variable `--mcptc-max-width` am Platzhalter oder einem Elternelement legt die Breite fest (Standard `520px`).
- `?lang=` in der Skript-URL legt die Sprache der Karte fest: `en`, `it`, `fr`, `de` oder `es`.
Wenn die Website eine Content Security Policy hat, erlaube `script-src https://mcp.tc` und `img-src data:` (das Icon ist eingebettet).
Für ein README oder andere Markdown-Dokumentation nimm stattdessen das Badge:
```markdown
[](https://mcp.tc/i/obsidian)
```
Referenz: https://mcp.tc/de/embedÄnderungsverlauf
Dieser Server läuft auf deinem Computer, deshalb verfolgen wir sein PyPI-Paket: Jede neue Version erscheint hier, dazu Änderungen seines Betreibers.
Häufige Fragen
Kann ich mcp.tc/i/obsidian in meinen MCP-Client einfügen?
Nein. Obsidian läuft auf deinem eigenen Rechner und wird von deinem Client gestartet, hat also keine Webadresse, mit der man sich verbinden könnte. Der Quick-Link ist die Seite zum Teilen; der Installationsbefehl lautet uvx mcp-obsidian.
Braucht Obsidian einen API-Schlüssel?
Ja. Er liest OBSIDIAN_API_KEY aus seiner Umgebung, und OBSIDIAN_API_KEY ist geheim. Trag den Wert in die Konfiguration deines Clients auf deinem eigenen Rechner ein, nie in eine geteilte Datei.
Ist Obsidian ein Remote- oder ein lokaler Server?
Lokal. Dein Client startet ihn mit uvx mcp-obsidian als Prozess auf deinem Rechner; dafür brauchst du uv (Python).
Was kann Obsidian?
Du kannst damit Dateien und Verzeichnisse im Vault auflisten, Inhalt einer Notiz lesen und Text in allen Vault-Dateien suchen.
Welche Clients können ihn nutzen?
Jeder Client, der lokale Server startet: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed und andere. claude.ai und ChatGPT verbinden sich nur mit Remote-Servern.
Verfolgt mcp.tc Änderungen an Obsidian?
Teilweise. Er läuft auf deinem Computer, deshalb verfolgen wir sein PyPI-Paket: Sein Tab Verlauf zeigt jede neue Version und Änderungen seines Betreibers. Folge dem Eintrag, um eine E-Mail zu bekommen, wenn er sich ändert.
Wer hat diese Seite geschrieben?
Der Roboter von mcp.tc hat die öffentlichen Metadaten von Obsidian (seine Paket- und Repository-Seiten) gelesen, und ein KI-Modell hat daraus den Text entworfen. Ein Mensch prüft alles, was die Prüfungen nicht bestätigen können. Der Text kann trotzdem falsch sein; wenn dir ein Fehler auffällt, nutze Eintrag melden auf dieser Seite. Diese Übersetzung hat ein KI-Modell aus dem englischen Text erstellt.
mcp.tc steht in keiner Verbindung zu Markus Pfundstein. Diese Seite entstand aus den öffentlichen Metadaten von Obsidian, zuletzt geprüft am 3. Okt. 2026, und ein KI-Modell hat die Beschreibung geschrieben, sie kann also Fehler enthalten. Namen und Marken gehören ihren Inhabern. Stimmt etwas nicht? Eintrag melden. Die Übersetzung hat ein KI-Modell aus dem englischen Text erstellt.