Obsidian
MCP-Server von Markus Pfundstein
Read, search and edit notes in an Obsidian vault through the Local REST API plugin.
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
Connects an assistant to an Obsidian vault through the Obsidian Local REST API community plugin. It can list files and folders, read note contents, search across the vault, append or patch content in notes, and delete files.
Runs locally over stdio with uvx mcp-obsidian and needs Python 3.11 or newer. The Local REST API plugin must be installed and enabled in Obsidian, and the server needs the plugin's API key in OBSIDIAN_API_KEY. Host and port are optional and default to 127.0.0.1 and 27124.
Was du damit machen kannst
- List files and directories in the vault
- Read the contents of a note
- Search for text across all vault files
- Append content to new or existing notes
- Insert content relative to a heading, block or frontmatter field
- Delete files or directories from the vault
Tools
Obsidian zeigt seine Tools nur Clients mit Schlüssel, deshalb können wir sie hier nicht auflisten.
Beispiel-Prompts
Get the contents of my last architecture call note and summarize it
Search my vault for notes that mention Azure CosmosDB
Summarize the last meeting notes into a new note called summary meeting.md
Append a to-do list to my project plan note
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.
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 als Prozess auf deinem Rechner, mit uvx mcp-obsidian, was uv (Python) braucht.
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.
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.
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
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.jsonmcp.tc ist nicht mit Markus Pfundstein verbunden. 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.