Obsidian MCP Tools — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Plugin Obsidian local + pont MCP
Recherche sémantique via l'intégration Smart Connections
Exécution de prompts Templater depuis Claude
CRUD complet de fichiers : lecture, écriture, ajout, lien, frontmatter
Conscient des notes quotidiennes et du journal
Les données du vault ne quittent jamais votre machine

Démo en direct

Aperçu en pratique

obsidian-mcp-tools.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Obsidian MCP Tools

Comment vraiment interroger votre second cerveau au lieu de le grepper

👤 Utilisateurs Obsidian PKM avec plus de 1000 notes ⏱ ~20 min intermediate

Quand l'utiliser : Vous savez que vous avez écrit sur quelque chose il y a des mois, mais la recherche par mot-clé passe toujours à côté.

Prérequis

Obsidian + ce plugin + plugin Smart Connections — Installez les deux depuis les Plugins communautaires ; Smart Connections indexera au premier lancement

Déroulement

Vérification de l'index

Verify Smart Connections has finished embedding my vault. Report total notes indexed.✓ Copié

→ Nombre de notes indexées ; modèle d'embedding utilisé
Rappel sémantique

Find notes related to 'why I left my last job' even if those exact words aren't in any note.✓ Copié

→ 5 notes classées par correspondance sémantique, avec extraits
Composer

Synthesize those into a short reflection note. Save under /Reflections/ with a wikilink to each source.✓ Copié

→ Nouvelle note créée ; les backlinks se résolvent

Résultat : Un second cerveau qui répond en concepts, pas en mots-clés.

Pièges

Le rappel sémantique remonte des notes personnelles sensibles — Utilisez le paramètre excludedFolders d'Obsidian dans Smart Connections pour exclure les dossiers privés

Combiner avec : humanizer-skill

Exécuter un template Templater depuis Claude avec prompts auto-remplis

👤 Utilisateurs Obsidian avancés avec des templates ⏱ ~10 min intermediate

Quand l'utiliser : Vous avez un template Templater « démarrage de projet » qui pose 5 prompts ; vous préféreriez que Claude les orchestre.

Prérequis

Templater installé avec des templates configurés — Plugin communautaire standard

Déroulement

Lister les templates

What Templater templates are available?✓ Copié

→ Liste de templates avec descriptions des prompts
Exécuter avec auto-remplissage

Run 'project_kickoff' for a project called 'Q3 onboarding overhaul'. Auto-answer the prompts based on context.✓ Copié

→ Nouvelle note créée avec le template ; prompts remplis

Résultat : Les templates s'exécutent depuis un chat au lieu d'une fenêtre modale.

Pièges

Certaines commandes Templater sont asynchrones et ont besoin de temps — L'outil MCP attend la complétion — mais n'enchaînez pas trop d'appels dans un seul appel

Construire automatiquement une note quotidienne depuis le calendrier et les tâches de la veille

👤 Utilisateurs Obsidian axés sur la productivité ⏱ ~15 min intermediate

Quand l'utiliser : Vous commencez chaque journée à éditer le même template « Daily » — automatisez-le.

Déroulement

Récupérer les données du jour

Read yesterday's daily note. Carry forward incomplete tasks. Pull today's calendar via google-calendar MCP.✓ Copié

→ Tâches reportées + événements d'aujourd'hui identifiés
Écrire le daily

Create today's daily note in /Daily/$(date +%F).md with the standard sections.✓ Copié

→ Note créée et ouverte

Résultat : Note quotidienne prête en 5 secondes.

Pièges

Le report duplique les tâches si la même tâche est dans 2 jours — Dédupliquez par texte de ligne avant d'écrire

Combiner avec : google-calendar

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

obsidian-mcp-tools + google-calendar

Construire des notes quotidiennes incluant les événements du jour

obsidian-mcp-tools + github

Miroir d'un tableau de projet dans une note vault

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
search_semantic	query, k?	Rappel au niveau conceptuel	1 requête Smart Connections
read_note	path	Récupérer une note unique	gratuit
write_note	path, content, mode: 'create'\|'append'\|'overwrite'	Créer ou mettre à jour une note	gratuit
list_templates	(aucun)	Découvrir ce qui est exécutable	gratuit
run_templater	template_name, prompt_answers: {}	Exécuter un workflow par template	gratuit

Coût et limites

Coût d'exécution

Quota d'API: Local — limité par le service d'embedding Smart Connections si basé sur le cloud
Tokens par appel: 100 à 1500 par note
Monétaire: Gratuit (le plugin) ; Smart Connections a des options locales gratuites + cloud payant
Astuce: Utilisez l'option d'embedding local dans Smart Connections pour éviter les coûts par requête

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Plugin local uniquement ; pas de stockage distant

Sortie de données : Local — sauf si Smart Connections est configuré pour utiliser des embeddings cloud

N'accordez pas à Claude l'accès en écriture au vault sans faire confiance à votre prompt ; utilisez des dossiers d'exclusion pour les zones sensibles

Dépannage

Erreurs courantes et correctifs

Les outils MCP n'apparaissent pas

Confirmez que le plugin Obsidian est activé et que le processus pont MCP fonctionne

Vérifier : Vérifiez la barre de statut du plugin ; redémarrez Obsidian

search_semantic ne retourne rien

Le job d'embedding Smart Connections n'est peut-être pas encore terminé — vérifiez sa progression

Vérifier : Ouvrez la barre latérale Smart Connections

write_note échoue avec « chemin hors du vault »

Les chemins sont relatifs à la racine du vault ; n'utilisez pas de chemins absolus

Alternatives

Obsidian MCP Tools vs autres

Alternative	Quand l'utiliser	Compromis
ergut/mcp-logseq	Vous utilisez Logseq plutôt qu'Obsidian	Écosystème différent ; même idée
AgriciDaniel/claude-obsidian (skill)	Vous voulez un workflow en forme de skill au-dessus des I/O de fichiers	Le skill est de plus haut niveau ; ce MCP fournit les briques de base

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills