📋 À savoir avant de commencer

Cette procédure vous permet de connecter Claude Desktop (l’assistant IA) à Obsidian pour accéder directement à vos notes. Une fois configurée, vous pourrez demander à Claude de lire, chercher ou analyser vos notes en temps réel.

Prérequis (vérifiez d’abord):

  • ✓ macOS (Mac moderne requis)
  • ✓ Obsidian installé et ouvert
  • ✓ Claude Desktop installé

⏱ Durée estimée: 15 minutes
📊 Niveau: Débutant (aucune connaissance technique requise)

Diagram de fonctionnement

ÉTAPE 1 – Installer les outils système (3 min)

1A. Ouvrir Terminal

  1. Appuyez sur Cmd + Espace (recherche Mac)
  2. Tapez Terminal et appuyez sur Entrée
  3. Une fenêtre noire s’ouvre

1B. Installer Homebrew

Homebrew est un “gestionnaire de packages” qui aide à installer des outils sur Mac.

Copiez ce texte entièrement:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Puis:

  1. Collez-le dans Terminal (Cmd + V)
  2. Appuyez sur Entrée
  3. Votre mot de passe Mac est demandé → Tapez-le et appuyez sur Entrée
  4. Attendez 2-3 minutes (des lignes vertes s’affichent)
  5. Une fois terminé: fermez Terminal

✅ Checkpoint: Homebrew est installé

1C. Installer uv

uv est l’outil qui permet à Claude de lancer le serveur MCP pour se connecter à Obsidian.

  1. Ouvrez Terminal à nouveau (Cmd + Espace → Terminal)
  2. Copiez ce texte:
brew install uv
  1. Collez dans Terminal (Cmd + V) et appuyez sur Entrée
  2. Attendez 1-2 minutes
  3. Fermez Terminal

✅ Checkpoint: Terminal affiche les informations sans ligne d’erreur rouge

ÉTAPE 2 – Configurer Obsidian (5 min)

2A. Installer le plugin “Local REST API”

  1. Ouvrez Obsidian
  2. En bas à gauche, cliquez sur l’icône roue dentée ⚙️ (Paramètres)
  3. Dans le menu de gauche, cliquez sur Extensions de la communauté
  4. Cliquez sur le bouton Parcourir (en haut)
  5. Dans la barre de recherche, tapez: Local REST API
  6. Cliquez sur le premier résultat “Local REST API”
  7. Cliquez sur Installer
  8. Une fois installé, cliquez sur Activer

Le plugin est maintenant activé. Vous pouvez le voir dans votre liste des extensions.

✅ Checkpoint: “Local REST API” apparaît dans vos extensions activées

2B. Récupérer votre clé API

La clé API = le “mot de passe secret” qui permet à Claude d’accéder à Obsidian.

  1. Toujours dans Extensions de la communauté, trouvez “Local REST API” dans la liste
  2. Cliquez sur l’icône roue dentée ⚙️ à côté du nom
  3. Regardez en bas du panneau: vous voyez une clé (longue série de chiffres/lettres)
    • Exemple: 4f64a8b9c2d1e5f3a8b9c2d1e5f3a8b9
  4. Sélectionnez et copiez cette clé entière (Cmd + C)
  5. Ouvrez TextEdit (Cmd + Espace → TextEdit) et collez-la temporairement
    • Vous l’utiliserez dans l’étape suivante

✅ Checkpoint: Votre clé API est sauvegardée quelque part (TextEdit, Notes, etc.)

ÉTAPE 3 – Configurer Claude Desktop (5 min)

3A. Accéder au fichier de configuration

  1. Ouvrez Finder (icône 😊 sur le dock)
  2. Cliquez sur Aller dans le menu en haut
  3. Cliquez sur Aller au dossier…
  4. Copiez-collez ce chemin:
~/Library/Application Support/Claude
  1. Appuyez sur Entrée
  2. Vous voyez un dossier qui s’ouvre
  3. Double-cliquez sur le fichier claude_desktop_config.json
  4. Si demandé, choisissez d’ouvrir avec TextEdit

Note : si jamais ce fichier n’existe pas, passez par les paramètres, developpeur et “Modifier la config”

3B. Modifier le fichier

Vous allez maintenant remplacer le contenu du fichier avec une nouvelle configuration.

  1. Si le fichier contient autre chose que {} il faudra modifier le fichier pour include la partie MCP. Dans le cas inverse, effacez tout le contenu du fichier.
  2. Copiez et collez ce texte:
{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "VOTRE_CLÉ_API_ICI",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

  1. Remplacez VOTRE_CLÉ_API_ICI par la clé que vous avez copiée à l’étape 2B

    • Exemple de résultat:
    "OBSIDIAN_API_KEY": "4f64a8b9c2d1e5f3a8b9c2d1e5f3a8b9"

  2. Vérifiez qu’il n’y a pas de ligne rouge (pas d’erreur de syntaxe)

  3. Appuyez sur Cmd + S pour sauvegarder

  4. Fermez TextEdit

✅ Checkpoint: Le fichier est sauvegardé sans erreurs

ÉTAPE 4 – Vérifier et tester (2 min)

4A. Redémarrer Claude Desktop

  1. Fermez complètement Claude Desktop (ne pas juste le minimiser)
    • Menu Claude → Quitter Claude Desktop
  2. Attendez 5 secondes
  3. Rouvrez Claude Desktop

4B. Vérifier la connexion

  1. Dans Claude Desktop, allez dans les paramètres ( cmd , )
  2. Cliquez sur Développeur
  3. Cherchez mcp-obsidian dans la liste et cliquez dessus
  4. Si vous le voyez: running Configuration correcte!

4C. Test fonctionnel

Testez maintenant que tout fonctionne:

  1. Demandez à Claude:
Montre-moi les 5 premiers fichiers dans mon vault Obsidian
  1. Si Claude vous répond avec une liste de fichiers → ✅ SUCCESS! Tout fonctionne!

🔧 Dépannage

❌ “mcp-obsidian” n’apparaît pas dans Tools

Vérifications (dans cet ordre):

1) Le fichier JSON est-il correct?

  • Rouvrez claude_desktop_config.json (Finder → Aller au dossier → ~/Library/Application Support/Claude)
  • Vérifiez qu’il n’y a pas de ligne rouge ou d’erreur
  • Vérifiez qu’il n’y a pas de caractères bizarres ou de guillemets cassés

2) Avez-vous bien redémarré Claude Desktop?

  • Quittez Claude Desktop complètement (pas juste minimiser)
  • Attendez 10 secondes
  • Rouvrez-le

3) L’outil uv est-il installé?

  • Ouvrez Terminal
  • Tapez: uv --version
  • Appuyez sur Entrée
  • Vous devriez voir un numéro (ex: uv 0.4.1)
  • Si erreur: réinstallez uv (refaites l’ÉTAPE 1C)

❌ Claude dit “Connexion refusée” ou “Erreur d’accès”

Solutions:

  1. Assurez-vous que Obsidian est bien OUVERT sur votre Mac
  2. Retournez à l’ÉTAPE 2B et vérifiez que votre clé API est correcte
    • Copiez-la à nouveau depuis Obsidian
    • Remettez-la dans le fichier config
  3. Redémarrez Claude Desktop
  4. Retestez

❌ Dans Obsidian: “Plugin Local REST API pas activé”

Le plugin existe mais n’est pas actif:

  1. Ouvrez Obsidian
  2. Allez dans Paramètres → Extensions de la communauté
  3. Cherchez “Local REST API” dans la liste
  4. Vérifiez que le bouton bascule est bleu/vert (activé)
  5. Si pas activé: cliquez dessus
  6. Fermez et rouvrez Obsidian
  7. Redémarrez Claude Desktop

❌ Message “Clé API invalide” ou “Authentification échouée”

  1. Retournez dans Obsidian → Paramètres → Extensions de la communauté → Local REST API
  2. Cliquez sur l’icône roue dentée
  3. Copiez la clé entière (en bas du panneau)
  4. Rouvrez claude_desktop_config.json
  5. Remplacez la clé dans OBSIDIAN_API_KEY
  6. Vérifiez qu’il n’y a pas d’espace avant/après la clé
  7. Sauvegardez
  8. Redémarrez Claude Desktop

✅ Tout fonctionne!

Vous pouvez maintenant demander à Claude de:

  • Lister les fichiers de votre vault
  • Chercher des notes spécifiques
  • Analyser le contenu de vos notes
  • Créer de nouveaux fichiers Obsidian

Exemples de commandes utiles:

  • “Résume mes notes sur [sujet]”
  • “Cherche tous les fichiers contenant [mot-clé]”
  • “Montre-moi mes fichiers non traités”
  • “Crée une note Obsidian avec [contenu]”

Ressources complémentaires