Meilleur serveur MCP Obsidian pour Claude : installation et options

Claude est performant, mais il n’a jamais vu vos notes. Demandez-lui les notes de la dernière réunion trimestrielle ou l’essai à moitié écrit enfoui dans votre coffre, et il ne pourra que deviner. Un serveur MCP Obsidian comble cet écart. Il ouvre une porte contrôlée vers vos fichiers markdown, pour que Claude puisse rechercher, lire et écrire des notes, tandis que vous restez maître de ce qu’il touche.

Le hic, c’est le choix. Plus d’une dizaine de serveurs existent, et les noms de packages, les plugins et les ports ont beaucoup changé au cours de 2026. Cet article vous aide à identifier le serveur qui mérite votre temps, détaille l’installation exacte pour Claude Desktop et Claude Code, et signale les erreurs qui font perdre un après-midi. En bref : choisissez mcpvault pour un démarrage rapide sans plugin, et passez à un serveur basé sur REST, comme obsidian-mcp-server de cyanheads, lorsque vous voulez qu’Obsidian lui-même soit dans la boucle.

💡 Verdict rapide : Pas de plugin et pas d’application ouverte ? Utilisez un serveur système de fichiers. Vous voulez la note active, les commandes et les notes périodiques ? Utilisez un serveur Local REST API.

Ce que fait un serveur MCP Obsidian

MCP signifie Model Context Protocol, le standard ouvert qu’Anthropic a introduit pour que les applications d’IA puissent accéder à des outils externes via de petits programmes appelés serveurs. Un serveur MCP Obsidian est l’un de ces programmes. Il se place entre Claude et votre coffre, un simple dossier de fichiers markdown, et expose une courte liste d’outils : lister les fichiers, lire une note, rechercher, ajouter du texte, modifier une section et, dans certains serveurs, déplacer ou supprimer des notes.

Comment Claude lit votre coffre

Quand vous posez une question, Claude détermine si un appel d’outil peut l’aider. Tapez « trouvez mes notes sur le test de tarification » et il appelle l’outil de recherche, reçoit les chemins de fichiers et les extraits, puis appelle l’outil de lecture sur les meilleurs résultats. Le serveur tourne sur votre propre machine, et Claude Desktop vous demande votre accord avant d’utiliser un outil.

Un point à garder en tête : toute note lue par Claude fait partie de la conversation, ce qui signifie que son texte est envoyé à Anthropic pour traitement. Gardez les contenus vraiment privés hors du dossier que vous exposez.

Système de fichiers ou Local REST API

Tous les serveurs Obsidian relèvent de l’une de ces deux conceptions, et ce choix conditionne tout le reste :

• Les serveurs système de fichiers lisent et écrivent directement les fichiers .md. Ils n’ont besoin que d’un chemin de coffre, fonctionnent alors qu’Obsidian est fermé et s’installent en une seule ligne. Ils ne voient pas l’état en direct d’Obsidian, comme la note ouverte.
• Les serveurs Local REST API communiquent avec Obsidian via le plugin communautaire Local REST API. Ils peuvent accéder à la note active, exécuter des commandes Obsidian et utiliser les notes périodiques, mais Obsidian doit être lancé et vous devez fournir un token issu du plugin.

Les meilleurs serveurs comparés

Les listes d’annuaires changent chaque semaine. Je laisse donc de côté le nombre d’étoiles pour comparer ce qui affecte réellement votre installation. Lisez le README de chaque projet avant de copier une commande, car plusieurs projets ont renommé leurs packages ou publié des versions incompatibles cette année.

Côte à côte

💡 Piège de nom : le package npm autrefois appelé mcp-obsidian a été renommé @bitbonsai/mcpvault plus tôt en 2026. Les anciens tutoriels qui utilisent l’ancien nom peuvent vous orienter vers le mauvais package, alors copiez les noms depuis le README actuel.

mcpvault pour une installation facile

mcpvault est le chemin le plus court entre zéro et une connexion fonctionnelle au coffre. Vous passez un seul argument, le chemin du coffre, et il lit directement les fichiers. Si vous omettez le chemin, il utilise le répertoire de travail courant, ce qui est pratique lorsque vous lancez Claude Code depuis le coffre. Ses outils gèrent la lecture et l’écriture des notes, les modifications de type patch, la recherche, le frontmatter et les tags, même si la liste à jour figure dans le README.

Comme il ne passe jamais par l’API d’Obsidian, l’application peut rester fermée, et il reste rapide sur un coffre de plusieurs milliers de notes. Le compromis : il ne peut pas exécuter de commandes Obsidian ni savoir quelle note vous consultez.

cyanheads pour un usage intensif

obsidian-mcp-server de cyanheads est écrit en TypeScript et se connecte via le plugin Local REST API. Il affichait le plus grand nombre de téléchargements hebdomadaires npm dans les annuaires que j’ai consultés, et une version récente l’a adapté à la version 4 du plugin. Son README indique la recherche globale, la recherche et le remplacement à l’intérieur d’une note, ainsi que la gestion du frontmatter et des tags.

Choisissez-le quand Claude est un partenaire quotidien plutôt qu’un simple essai. Cette profondeur a un prix : un élément mobile de plus, à savoir le plugin, son token et une fenêtre d’Obsidian ouverte.

Serveurs REST pour les fonctions en direct

mcp-obsidian de MarkusPfundstein est l’option Python. Vous le lancez avec uvx, et il communique avec le plugin à 127.0.0.1 sur le port HTTPS 27124. Ses outils incluent la recherche, l’ajout de texte à une note et la modification de contenu sous un titre précis. Le projet est resté inactif pendant longtemps avant le retour de son mainteneur en mai 2026, donc consultez les commits récents avant de vous engager.

Deux autres options méritent un coup d’œil. Obsidian MCP Tools s’installe depuis Obsidian et ajoute la recherche sémantique via Smart Connections, ainsi que la prise en charge de Templater. Et les versions récentes de Local REST API intègrent un endpoint MCP, ce qui vous permet peut-être de connecter Claude directement au plugin, sans programme Node ou Python intermédiaire. Consultez les notes de version du plugin pour l’adresse exacte.

Mon choix selon la situation :

1. Vous voulez un résultat en cinq minutes : mcpvault.
2. Vous utilisez Obsidian toute la journée et voulez des outils riches : cyanheads.
3. Vous êtes déjà dans un environnement Python : mcp-obsidian.
4. Vous voulez le moins de programmes installés : l’endpoint intégré du plugin, si votre version le propose.

Installation pour Claude Desktop

Avant de toucher à une configuration, vérifiez trois points. Node.js (LTS actuel) est installé si vous prévoyez d’utiliser un serveur npx, ou uv si vous prévoyez d’utiliser uvx. Claude Desktop est installé et vous êtes connecté. Et vous connaissez le chemin absolu de votre coffre, par exemple /Users/you/Documents/MyVault ou C:\Users\you\Documents\MyVault.

Pour un serveur REST, il vous faut aussi le plugin. Dans Obsidian, ouvrez Paramètres, Plugins communautaires, Parcourir, recherchez Local REST API, installez-le et activez-le, puis copiez le token affiché sur sa page de réglages. Le plugin écoute sur le port HTTPS 27124 avec un certificat auto-signé. Un port HTTP, 27123, existe mais il est désactivé par défaut.

Modifier le fichier de configuration

Dans Claude Desktop, ouvrez Paramètres, puis Développeur, puis Modifier la configuration. Cela ouvre claude_desktop_config.json, qui se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows. Ajoutez mcpvault de cette façon :

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["@bitbonsai/mcpvault@latest", "/Users/you/Documents/MyVault"]
    }
  }
}

Copier le prompt

Sous Windows, doublez les antislashs du chemin : "C:\\Users\\you\\Documents\\MyVault". Enregistrez le fichier, puis quittez complètement Claude Desktop (depuis la barre de menus ou la zone de notification, pas seulement la fenêtre) et rouvrez-le. L’icône des outils dans la zone de chat doit maintenant afficher les outils Obsidian.

💡 Astuce PATH : Claude Desktop n’hérite pas du PATH de votre shell. Si le serveur ne démarre pas, remplacez npx par le chemin absolu affiché par which npx sous macOS ou where npx sous Windows.

Connecter un serveur REST

Un serveur REST utilise le même fichier avec une entrée différente. Voici la structure pour mcp-obsidian :

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Copier le prompt

Ajoutez une entrée supplémentaire dans le bloc env : votre token de plugin, sous le nom exact de variable indiqué dans le README du serveur. Les noms varient d’un projet à l’autre, c’est pourquoi je ne vais pas en deviner un ici. Gardez Obsidian ouvert pendant que vous discutez, car le serveur accède à votre coffre via le plugin.

Installation pour Claude Code

Claude Code ajoute les serveurs depuis le terminal, sans modifier de JSON.

Installation en une commande

Pour mcpvault :

claude mcp add obsidian --scope user -- npx @bitbonsai/mcpvault@latest /path/to/vault

Copier le prompt

L’option --scope user rend le serveur disponible dans tous les projets. La portée locale par défaut le limite au projet en cours, et la portée projet écrit un fichier .mcp.json que vous pourriez versionner avec git. Ne mettez jamais un token dans un .mcp.json partagé.

Pour un serveur REST, transmettez les valeurs d’environnement avec -e :

claude mcp add obsidian --scope user -e OBSIDIAN_HOST=127.0.0.1 -e OBSIDIAN_PORT=27124 -- uvx mcp-obsidian

Copier le prompt

Ajoutez le token du plugin de la même façon, en utilisant le nom de variable indiqué dans le README.

Vérifier et tester avec des prompts

Exécutez claude mcp list pour voir si le serveur apparaît comme connecté, ou tapez /mcp dans une session. Testez ensuite des prompts qui prouvent que chaque outil fonctionne :

• « Listez les dix notes modifiées le plus récemment et résumez chacune en une ligne. »
• « Recherchez les notes qui mentionnent le test de tarification et rédigez un point d’avancement à partir d’elles. »
• « Ajoutez mes trois décisions du jour à ma note quotidienne, sous un titre intitulé Décisions. »
• « Trouvez les notes qui mentionnent une personne par son nom sans jamais faire de lien vers sa page. »

Les équipes peuvent partager un même coffre via un dossier synchronisé, et chaque personne ajoute le serveur sur sa propre machine. Limitez l’accès en écriture aux personnes qui en ont besoin.

Bonnes pratiques avant l’accès en écriture

L’accès en lecture présente peu de risques. L’accès en écriture, lui, en présente : une seule instruction mal comprise peut écraser une note ou supprimer un fichier. Quelques habitudes suffisent à écarter l’essentiel du danger.

Sauvegardez d’abord

Transformez le coffre en dépôt git avec le plugin Obsidian Git, vérifiez que l’historique de versions d’Obsidian Sync est activé, ou copiez au minimum le dossier sur un second disque. Testez ensuite une restauration au moins une fois. Une sauvegarde que vous n’avez jamais restaurée n’est qu’un espoir.

Validez les outils d’écriture et de suppression un appel à la fois, jusqu’à ce que vous ayez confiance dans leur comportement. Lisez la modification proposée avant de cliquer sur Autoriser.

Limiter ce que Claude peut toucher

Les serveurs système de fichiers acceptent n’importe quel chemin de dossier, donc pointez-les vers un sous-dossier dédié plutôt que vers l’ensemble du coffre. Gardez les journaux intimes et les brouillons privés en dehors. Stockez les tokens uniquement dans votre configuration locale, jamais dans un dépôt.

Corriger les échecs d’installation courants

La plupart des premières tentatives échouent pour des raisons banales. Parcourez ces points dans l’ordre.

Le serveur apparaît en échec

• Node ou uv manquant. Exécutez node --version ou uv --version dans un terminal.
• Mauvais PATH. Utilisez le chemin absolu vers npx ou uvx dans la configuration.
• Ancien nom de package. Remplacez mcp-obsidian sur npm par @bitbonsai/mcpvault.
• JSON cassé. Cherchez une virgule finale, un guillemet manquant ou des antislashs simples dans un chemin Windows.
• Application obsolète. Quittez complètement Claude Desktop et rouvrez-le.

Si rien ne fonctionne, ouvrez les fichiers de journal MCP. Sous macOS, ils se trouvent dans ~/Library/Logs/Claude/, et sous Windows dans %APPDATA%\Claude\logs. Les dernières lignes indiquent généralement le problème exact.

Erreurs de port et de certificat

Les serveurs REST ajoutent leurs propres échecs. Obsidian doit être lancé avec le plugin activé. Une réponse 401 ou 403 signifie que le token ne correspond pas : copiez-le à nouveau, sans espace à la fin. Une erreur de certificat sur le port 27124 vient du certificat auto-signé du plugin : suivez le README du serveur pour l’approuver, ou activez le port HTTP 27123 dans les réglages du plugin et utilisez-le uniquement sur localhost. Si un autre programme occupe le port, modifiez-le à la fois dans le plugin et dans le bloc env de votre configuration.

Rédiger des notes avec Claude sur PicassoIA

MCP fonctionne à l’intérieur de Claude Desktop et de Claude Code, donc un outil de navigateur ne peut pas le remplacer. Ce que PicassoIA ajoute, c’est l’autre moitié du travail : rédiger et nettoyer le texte avant qu’il n’atteigne votre coffre, sans rien installer. Claude Sonnet 5 convient bien, et Claude Opus 4.7 ainsi que Claude 4.5 Haiku prennent en charge les tâches plus lourdes ou plus légères.

Comment utiliser Claude Sonnet 5 sur PicassoIA :

1. Ouvrez la page de Claude Sonnet 5.
2. Collez votre matière brute dans Prompt : une transcription brouillonne, des puces désordonnées ou un amas de recherches. Indiquez ensuite le format de note souhaité.
3. Renseignez System Prompt une seule fois avec les conventions de votre coffre, comme le frontmatter YAML, les wikilinks pour les personnes et votre style de titres.
4. Choisissez un niveau d’Effort, puis lancez la génération.
5. Copiez le résultat dans Obsidian, ou confiez-le à votre Claude connecté à MCP pour le ranger dans le bon dossier.

💡 Le champ image est utile pour la recherche : photographiez un tableau blanc, laissez Claude le transformer en note structurée, et rangez-la dans votre coffre.

Créer vos propres images sur Picasso IA

Un coffre rempli de texte est plus facile à parcourir lorsque les notes portent un visuel. Une image d’en-tête pour une note de projet, un moodboard pour un brief de design, une scène photoréaliste pour un brouillon d’histoire : chacun demande un prompt court et quelques secondes sur Picasso IA.

Essayez Seedream 4.5 pour des scènes détaillées et soignées, GPT Image 2 lorsque votre prompt est long et précis, FLUX 2 Pro pour une photographie réaliste et nette, ou P-Image si vous voulez des résultats rapidement. Décrivez le sujet, la lumière et l’objectif, et formulez-les aussi concrètement qu’une liste de prises de vue de photographe.

Installez votre serveur MCP Obsidian cette semaine, puis ouvrez Picasso IA et créez la première image de votre propre coffre. Testez quelques prompts, gardez ceux qui conviennent à vos notes, et construisez une habitude visuelle en parallèle de l’habitude écrite.