Wir und ausgewählte Dritte verwenden Cookies oder ähnliche Technologien für technische Zwecke und, mit deiner Einwilligung, um zu analysieren, wie die Website genutzt wird.

Du kannst deine Einwilligung jederzeit frei erteilen, verweigern oder widerrufen.

Obsidian

MCP-Server von Markus Pfundstein

Notizen in einem Obsidian-Vault über das Plugin Local REST API lesen, durchsuchen und bearbeiten.

Läuft lokal (Läuft auf deinem Rechner: Die Seite nennt den Installationsbefehl)Läuft mit uvxAPI-Schlüssel nötig

Obsidian installieren

Läuft auf deinem Rechner. Dein Client startet ihn mit diesem Befehl:

uvx mcp-obsidian

Braucht uv (Python) auf deinem Rechner. Die Schritte unten zeigen, wo der Befehl in jedem Client hingehört.

  • OBSIDIAN_API_KEY geheim 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

  1. 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
  1. 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

  1. Öffne Settings → Developer → Edit Config. Das öffnet claude_desktop_config.json. Füge hinzu:
claude_desktop_config.json
{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}
  1. 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

Oder trag ihn von Hand in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (dieses Projekt) ein:

mcp.json
{
  "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:

.vscode/mcp.json
{
  "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

  1. Füge ihn zu ~/.config/devin/mcp_config.json (macOS und Linux) oder %APPDATA%\devin\mcp_config.json (Windows) hinzu:
mcp_config.json
{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}
  1. 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-obsidian

Oder bearbeite ~/.codex/config.toml direkt:

config.toml
[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-obsidian

Damit 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

Badge-Vorschau, hellBadge-Vorschau, dunkel
Markdown
[![Obsidian on mcp.tc](https://mcp.tc/i/obsidian/badge.svg)](https://mcp.tc/i/obsidian)
HTML
<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

HTML
<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

HTML
<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.json

Was jedes Feld bedeutet

KI-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.

Markdown
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
[![Obsidian on mcp.tc](https://mcp.tc/i/obsidian/badge.svg)](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.

Folge Obsidian, und wir schicken dir eine E-Mail, wenn sich etwas ändert.

  1. , Automatische Prüfung

    Beginn der Beobachtung: Version 0.2.3.

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.