Obsidian

Serveur MCP par Markus Pfundstein

Read, search and edit notes in an Obsidian vault through the Local REST API plugin.

S’exécute en local (Tourne sur votre machine : sa page donne la commande d’installation)S’exécute avec uvxClé API requise

Installer Obsidian

Tourne sur votre machine. Votre client le lance avec cette commande :

uvx mcp-obsidian

Nécessite uv (Python) sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.

  • OBSIDIAN_API_KEY secret API key of the Obsidian Local REST API plugin.

Partager ce serveur

Ouvre cette page, avec la commande d’installation et les étapes de configuration.

mcp.tc/i/obsidian

Présentation

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.

Ce que vous pouvez faire

  • 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

Outils

Obsidian ne présente ses outils qu’aux clients munis d’une clé, nous ne pouvons donc pas les afficher ici.

Exemples de 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

Configuration

Chaque client lance Obsidian sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.

Claude Code

  1. Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio obsidian --env "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" -- uvx mcp-obsidian
  1. Démarrez Claude Code et tapez /mcp. obsidian devrait apparaître comme connecté.

Ajoutez --scope user pour le rendre disponible dans tous vos projets. Remplacez les espaces réservés par vos propres valeurs.

Claude Desktop

  1. Ouvrez Settings → Developer → Edit Config. Cela ouvre claude_desktop_config.json. Ajoutez :
claude_desktop_config.json
{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}
  1. Enregistrez le fichier et redémarrez Claude Desktop. Remplacez les espaces réservés par vos propres valeurs.

Nécessite uv (Python) sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.

Cursor

Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :

mcp.json
{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}

Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

VS Code

Ajoutez-le à .vscode/mcp.json. VS Code demande le secret la première fois et le stocke de façon sécurisée :

.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
    }
  ]
}

Nécessite uv (Python) sur votre ordinateur.

Devin Desktop

  1. Ajoutez-le à ~/.config/devin/mcp_config.json (macOS et Linux) ou %APPDATA%\devin\mcp_config.json (Windows) :
mcp_config.json
{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}
  1. Actualisez la liste des serveurs MCP dans Cascade. Remplacez les espaces réservés par vos propres valeurs.

Devin Desktop est le nouveau nom de Windsurf.

Codex

codex mcp add obsidian --env "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" -- uvx mcp-obsidian

Ou modifiez directement ~/.codex/config.toml :

config.toml
[mcp_servers.obsidian]
command = "uvx"
args = ["mcp-obsidian"]
env = { OBSIDIAN_API_KEY = "<YOUR_OBSIDIAN_API_KEY>" }

Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

Gemini CLI

gemini mcp add -e "OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY>" obsidian uvx mcp-obsidian

Cela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.

Tout client

La plupart des clients qui lancent des serveurs locaux acceptent cette forme :

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}

Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.

Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.

FAQ

Puis-je coller mcp.tc/i/obsidian dans mon client MCP ?

Non. Obsidian tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est uvx mcp-obsidian.

Obsidian a-t-il besoin d’une clé API ?

Oui. Il lit OBSIDIAN_API_KEY dans son environnement, et OBSIDIAN_API_KEY est un secret. Mettez la valeur dans la configuration de votre client, sur votre propre machine, jamais dans un fichier partagé.

Obsidian est-il un serveur distant ou local ?

Local. Votre client le lance comme un processus sur votre ordinateur avec uvx mcp-obsidian, qui nécessite uv (Python).

Quels clients peuvent l’utiliser ?

Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.

Qui a rédigé cette page ?

Le robot de mcp.tc a lu les métadonnées publiques de Obsidian (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page.

Intégrer

Affichez Obsidian dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations

Badge pour README

Aperçu du badge, clairAperçu du badge, sombre
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>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

HTML
<script src="https://mcp.tc/w/obsidian.js" async></script>

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.

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>

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

https://mcp.tc/i/obsidian.json

Ce que signifie chaque champ

mcp.tc n’est pas affilié à Markus Pfundstein. Cette page a été construite à partir des métadonnées publiques de Obsidian, vérifiées pour la dernière fois le 3 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche.