La plupart des gens qui cherchent "Obsidian MCP" ont déjà un vault qui déborde et une idée en tête : brancher une IA dessus pour que ça devienne enfin utile. C'est une bonne intuition à moitié. MCP donne à un assistant IA l'accès à tes notes. Ce qu'il ne fait pas : te dire où ranger quoi, supprimer les doublons, appliquer tes conventions de nommage, ou transformer un bazar de 800 fichiers en second cerveau fonctionnel. Cet article t'explique exactement ce que tu obtiens, comment le brancher, et ce qu'il faut construire par-dessus pour que l'accès devienne une vraie méthode de travail.
Ce qu'est MCP en une minute, sans jargon
MCP signifie Model Context Protocol. C'est une norme ouverte, créée par Anthropic en 2024, et désormais gérée par la Linux Foundation. Son principe est simple : définir un langage standard pour qu'une IA puisse se connecter à des outils extérieurs, qu'il s'agisse d'une base de données, d'un agenda, d'un système de fichiers ou d'une application comme Obsidian.
L'image la plus juste, c'est celle de la prise électrique standardisée. Avant MCP, chaque outil IA devait développer sa propre connexion sur mesure vers chaque application. Avec MCP, n'importe quel assistant compatible peut se brancher sur n'importe quel serveur MCP via le même protocole. Claude, GPT-4o, Gemini : ils parlent tous la même langue côté connecteur.
Concrètement, un serveur MCP est un petit programme qui tourne en local (ou à distance) et expose des "outils" : lire un fichier, écrire dans un fichier, lister des dossiers, faire une recherche. L'IA client appelle ces outils comme elle appellerait une fonction. Elle ne voit que ce que le serveur lui autorise à voir.
Pour Obsidian, l'intérêt est direct : tes notes sont des fichiers Markdown stockés quelque part sur ton disque. Un serveur MCP peut exposer ce dossier à un assistant IA, qui peut alors lire, chercher, créer et modifier des notes à la demande.
Ce que ça débloque concrètement sur un vault Obsidian
Une fois un serveur MCP branché sur ton vault, tu obtiens un assistant qui peut :
- Lire une note précise quand tu la mentionnes par titre ou par chemin.
- Faire une recherche plein texte dans l'ensemble du vault pour trouver toutes les occurrences d'un terme.
- Créer une nouvelle note avec un contenu que tu lui dictes, au bon endroit dans l'arborescence si tu lui indiques où.
- Modifier une note existante : ajouter une section, corriger un passage, reformater un contenu.
- Lister le contenu d'un dossier pour te donner une vue de ce qui existe à un endroit du vault.
En pratique, ça change quelque chose de réel sur des tâches concrètes. Tu peux demander à l'IA de rédiger le compte rendu d'une réunion directement dans la bonne note du projet, de retrouver une décision que tu te rappelles vaguement avoir notée en mars, ou de créer une série de notes à partir d'un plan que tu lui souffle. Plus besoin de copier-coller entre l'interface de l'IA et Obsidian.
Ce que ça ne remplace pas en revanche : ta présence. L'IA agit sur instruction. Elle ne surveille pas ton vault en permanence pour ranger ce qui arrive. Ce point mérite sa propre section, on y revient.
Comment brancher une IA sur Obsidian : les deux options réelles
Option 1 : un serveur MCP dédié à Obsidian
Il existe plusieurs serveurs MCP conçus pour Obsidian. Le plus connu est obsidian-mcp, disponible sur GitHub, qui expose les outils standard (lire, écrire, chercher, lister). L'installation se fait en quelques étapes :
- Installer Node.js si ce n'est pas déjà fait.
- Cloner ou installer le paquet npm du serveur MCP.
- Déclarer ce serveur dans la configuration MCP de ton client IA (Claude Desktop, par exemple, a un fichier
claude_desktop_config.jsonoù tu listes tes serveurs). - Pointer le serveur vers le dossier de ton vault Obsidian.
- Relancer le client : les outils apparaissent dans l'interface.
Le prérequis côté IA : un abonnement Claude incluant Claude Desktop ou une application compatible MCP. Il n'y a pas de clé API supplémentaire à configurer, pas d'abonnement tiers. C'est le principal avantage de cette approche : une fois en place, c'est transparent.
Le point de friction reste l'installation initiale. Si tu n'es pas à l'aise avec un terminal, le fichier de configuration JSON et les chemins de dossiers, le setup peut prendre une demi-heure à une heure. Ce n'est pas insurmontable, mais c'est réel.
Option 2 : Claude Code, qui lit déjà le disque sans MCP
C'est la solution que je recommande souvent en premier, parce qu'elle est plus simple et que beaucoup de gens ne la connaissent pas : Claude Code lit directement les fichiers de ton disque, sans serveur MCP intermédiaire.
Claude Code est un outil en ligne de commande (CLI) fourni par Anthropic dans les abonnements Claude Pro ou supérieurs. Tu le lances depuis un terminal dans le dossier de ton vault, et il a accès à tous les fichiers du répertoire courant. Il peut lire, créer, modifier des notes Markdown exactement comme un serveur MCP le ferait, mais sans configuration supplémentaire.
Si ton vault est en local et que tu veux juste commencer à tester, brancher Claude Code sur Obsidian est la voie la plus directe. MCP devient vraiment utile quand tu veux une intégration persistante dans Claude Desktop, ou quand tu combines Obsidian avec d'autres serveurs MCP (agenda, base de données, outils métier).
Pour un usage quotidien simple sur un vault local, MCP n'est pas obligatoire. Claude Code suffit dans la majorité des cas.
| Critère | Serveur MCP Obsidian | Claude Code (CLI) |
|---|---|---|
| Installation | Node.js + config JSON (30 à 60 min) | npm install -g @anthropic-ai/claude-code (5 min) |
| Interface | Claude Desktop, intégration native | Terminal / ligne de commande |
| Abonnement requis | Claude Pro ou supérieur | Claude Pro ou supérieur |
| Accès vault local | Oui, via serveur | Oui, natif |
| Combinaison multi-outils MCP | Oui | Oui (depuis Claude Code 1.x) |
| Idéal pour | Intégration quotidienne dans Claude Desktop, multi-serveurs | Premier test, vault local simple, profils techniques |
Ce que MCP ne fait pas (et c'est là que ça coince)
C'est le point que presque aucun tutoriel ne mentionne clairement, et c'est pourtant le plus important.
MCP donne un accès. Il ne donne pas une méthode.
Une fois ton serveur branché, l'IA peut lire et écrire dans ton vault. Mais elle ne sait pas :
- Où tu ranges les notes de réunion versus les notes de projet.
- Quel format tu utilises pour les comptes rendus.
- Ce qu'il faut faire quand une note existe déjà sur le même sujet.
- Quelles tags tu utilises et selon quelle logique.
- Si une note vieille de deux ans est obsolète ou toujours valide.
Sans ces règles, l'IA va créer des notes là où elle pense que c'est logique, avec les conventions qu'elle invente, sans se soucier de ce que tu avais construit avant. Résultat : le vault grossit plus vite qu'avant, mais pas mieux. Les doublons s'accumulent. Les notes orphelines se multiplient. L'arborescence dérive.
Ce n'est pas un défaut de MCP. C'est une limite fondamentale de l'approche "accès seul". L'outil fait ce qu'on lui demande. Si on ne lui a pas dit comment faire, il improvise, et l'improvisation à grande vitesse produit du bruit.
Il y a aussi ce que l'IA ne peut tout simplement pas faire avec MCP, quelle que soit la qualité du serveur :
- Lire une image ou une vidéo embarquée dans une note sans qu'elle soit décrite textuellement. Sur une vidéo sans sous-titres, elle préviendra qu'elle ne peut pas en extraire le contenu, plutôt que d'inventer un résumé.
- Surveiller ton vault en temps réel pour déclencher des actions automatiques. MCP est en mode requête/réponse, pas en mode daemon.
- Décider seule de ranger ou de supprimer quoi que ce soit. Elle agit toujours sur instruction explicite.
Ce qu'il faut ajouter par-dessus pour que ce soit utile au quotidien
La bonne nouvelle : les pièces manquantes sont connues et constructibles. Un vault branché sur une IA devient réellement puissant quand tu y ajoutes trois éléments.
Une arborescence décidée, pas subie
L'IA a besoin de savoir où mettre les choses. Pas d'une arborescence parfaite et complexe : d'une arborescence décidée, stable, avec des dossiers dont les noms sont auto-explicatifs. Quatre à huit dossiers racine suffisent pour la plupart des vault de freelances ou de dirigeants. L'important est que les noms soient assez clairs pour qu'une IA les comprenne sans explication supplémentaire.
Un fichier de règles (le CLAUDE.md ou équivalent)
C'est la pièce centrale. Claude Code lit automatiquement un fichier CLAUDE.md à la racine du vault avant chaque session. Dans ce fichier, tu décris tes conventions : format des dates, nommage des notes, logique des dossiers, comportement attendu pour chaque type de contenu. L'IA applique ces règles à chaque interaction sans que tu aies besoin de les répéter.
Un exemple concret de règle utile : "Les comptes rendus de réunion vont dans /Projets/[Nom du projet]/Réunions/, nommés YYYY-MM-DD-[sujet].md. S'il existe déjà une note sur le même sujet à la même date, complète-la plutôt que d'en créer une nouvelle." Ce genre d'instruction élimine 80 % des problèmes de doublons et de désordre.
Un déclencheur régulier
L'IA n'agit pas seule. Il faut un moment dans ta semaine où tu l'actives pour une session de rangement, de synthèse ou de mise à jour. Certains le font le vendredi en fin de journée, d'autres le lundi matin. Ce déclencheur peut être une commande rapide dans Claude Code, une routine dans Claude Desktop, ou un rappel dans ton agenda. L'important est que ça arrive vraiment, pas juste en théorie.
Ces trois éléments combinés, c'est précisément ce que j'ai construit dans un vault déjà monté : une arborescence testée, un fichier de règles prêt à l'emploi, et des routines hebdomadaires préconfigurées. Le but est de te faire gagner les deux à trois semaines que prend habituellement la phase de tâtonnement.
Si tu hésites sur le fait de partir sur Obsidian ou de rester sur un outil comme Notion, la question de la structure se pose avant même celle de l'IA : si tu hésites encore avec Notion, commence par là, parce que le choix de l'outil change l'approche de fond.
Et si tu veux le monter toi-même plutôt que de partir d'une base existante, c'est parfaitement faisable : j'ai écrit un comparatif honnête des deux options, avec les pièges à éviter.
Ce que ça ne remplace pas non plus : un agent métier
Un vault Obsidian branché sur MCP reste un outil personnel de gestion de connaissance. Si tu cherches quelque chose de différent, à savoir un agent IA qui traite des données clients, automatise des workflows métier, ou s'intègre dans une infrastructure d'entreprise, c'est un agent taillé pour une entreprise, ce qui relève d'un autre sujet et d'un autre budget. Je le mentionne parce que les deux choses se confondent parfois dans les recherches, mais elles ne répondent pas aux mêmes besoins.
FAQ : vos questions sur Obsidian MCP
MCP fonctionne-t-il avec tous les clients IA, ou seulement Claude ?
MCP est une norme ouverte, donc en théorie tout assistant compatible peut l'utiliser. En pratique fin 2025 et début 2026, Claude Desktop est le client le plus avancé côté intégration MCP native. D'autres clients (Cursor, Windsurf, certains clients GPT-4o) ont commencé à implémenter MCP, mais le niveau de support varie. Si tu pars sur Claude, tu as la compatibilité la plus mature aujourd'hui.
Est-ce que mes notes quittent mon ordinateur quand j'utilise MCP ?
Ça dépend du client IA que tu utilises. Quand Claude Desktop appelle un outil MCP local, le contenu de la note est transmis au modèle via l'API Anthropic pour traitement : il passe donc par leurs serveurs, exactement comme quand tu colles du texte dans une conversation Claude classique. Si la confidentialité de tes notes est un impératif absolu, c'est un point à considérer. Un modèle local (Ollama, LM Studio) avec un serveur MCP local est la seule option qui reste 100 % sur ta machine.
Mon vault est sur iCloud ou Google Drive, ça change quelque chose ?
Non pour la mécanique MCP : le serveur pointe vers un chemin local, que ce dossier soit synchronisé dans le cloud ou non. La synchronisation se passe indépendamment. En revanche, si le dossier est en cours de synchronisation au moment où l'IA écrit dans une note, il peut arriver des conflits de version. C'est rare, mais ça arrive. Lancer des sessions Claude Code quand le vault n'est pas en train de synchroniser activement est une bonne habitude.
Est-ce que l'IA peut vraiment tout lire dans mon vault, y compris les notes que je ne veux pas partager ?
Par défaut, le serveur MCP expose l'intégralité du dossier vault que tu lui pointes. Si tu veux protéger certaines notes, la solution la plus simple est de les mettre dans un sous-dossier exclu du chemin exposé, ou d'avoir un vault séparé pour le contenu sensible. Certains serveurs MCP permettent aussi de définir des dossiers exclus dans leur configuration.
Combien de temps prend l'installation d'un serveur MCP Obsidian ?
Pour quelqu'un à l'aise avec un terminal et un fichier JSON : entre 20 et 45 minutes pour la première installation, tests inclus. Pour quelqu'un qui n'a jamais touché à Node.js : compter une heure à deux heures, documentation incluse, avec quelques allers-retours pour corriger les chemins et les permissions. Claude Code reste la voie d'entrée recommandée si tu veux tester avant de t'engager dans cette installation.
Est-ce que MCP peut créer des liens internes Obsidian automatiquement ?
L'IA peut écrire des liens internes au format [[Nom de la note]] dans le Markdown, oui. Elle peut même chercher des notes existantes pour créer des liens pertinents si tu le lui demandes. Ce qu'elle ne fait pas automatiquement : scanner le vault à la création de chaque note pour identifier tous les liens possibles. C'est une tâche que tu lui délègues explicitement lors d'une session de travail.
Qu'est-ce qui se passe si je supprime une note que l'IA utilise comme référence ?
Rien d'automatique. MCP n'a pas de mémoire persistante entre les sessions. Si une note est supprimée, l'IA ne le sait pas jusqu'à ce qu'elle essaie de la lire et reçoive une erreur "fichier non trouvé". Elle te l'indique et te demande comment procéder. Il n'y a pas de mécanisme de détection des liens brisés intégré nativement : c'est un des points où le plugin Obsidian "Broken Links" ou une session de nettoyage manuelle garde sa valeur.
Par où commencer
Si tu veux tester avant de configurer quoi que ce soit : installe Claude Code, ouvre un terminal dans ton vault, et demande-lui de lire ta note la plus récente. Tu verras immédiatement ce que ça donne, sans aucun serveur MCP à configurer.
Si tu veux une intégration quotidienne dans Claude Desktop : prends le serveur MCP obsidian-mcp sur GitHub, suis la documentation d'installation, et consacre une heure à la configuration initiale. L'investissement est ponctuel.
Si tu veux sauter la phase de tâtonnement : la structure, les règles et les routines sont déjà prêtes dans le Coffre. Tu te concentres sur l'usage, pas sur la construction de l'infrastructure.
Dans tous les cas, la règle reste la même : l'accès ne remplace pas la méthode. Branche l'IA sur un vault structuré, et elle démultiplie ce que tu fais. Branche-la sur un bazar, elle accélère le bazar.
