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

Pourquoi l'utiliser

Fonctionnalités clés

Huit outils couvrant les notes, les balises, les frontmatters et la recherche
Modes de mise à jour Ajouter / Ajouter / Écraser - les agents n'ont pas besoin de régénérer des fichiers entiers
Opérations de niveau clé sur le front atomique
Recherche floue globale dans le coffre-fort
Couche de mise en cache pour des lectures répétées plus rapides

Démo en direct

Aperçu en pratique

obsidian-mcp-server.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-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

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

Cas d'usage

Usages concrets : Obsidian MCP Server

Capturez les idées dans la note quotidienne d'aujourd'hui de n'importe quel client MCP

👤 Utilisateurs d'Obsidian qui vivent dans le chat ⏱ ~5 min beginner

Quand l'utiliser : Vous êtes en pleine conversation avec Claude et souhaitez qu'une pensée soit enregistrée dans votre coffre-fort sans changer d'application.

Prérequis

Obsidian avec le plugin API REST local activé — Plugins communautaires → installer 'API REST locale' → copier la clé API
Client MCP configuré avec OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL — Voir le bloc de configuration ; L'URL de base est généralement http://127.0.0.1:27123

Déroulement

Vérifiez que la note quotidienne existe

Répertoriez les notes sous Daily/2026-04-17.md.✓ Copié

→ Chemin du fichier confirmé ou « introuvable »
Ajouter la capture

Ajoutez « - Idée : essayez X pour le bug de mise en cache » à Daily/2026-04-17.md.✓ Copié

→ Ajout confirmé sans écraser les entrées précédentes

Résultat : Un journal en cours que les agents peuvent ajouter, sans jamais s'encombrer.

Pièges

Utiliser le mode d'écrasement alors que vous vouliez ajouter — Toujours par défaut, ajouter ou ajouter des notes quotidiennes ; enregistrer l'écrasement pour les nouveaux brouillons

Combiner avec : filesystem

Transformez une semaine de notes en un document de révision

👤 Travailleurs du savoir effectuant des revues hebdomadaires ⏱ ~20 min intermediate

Quand l'utiliser : Vous avez besoin d'une synthèse du vendredi à travers les notes éparses de la semaine.

Prérequis

Notes étiquetées ou datées — Utilisez #weekly ou un dossier Daily/

Déroulement

Rechercher dans les notes de la semaine

Recherche globale : notes modifiées cette semaine sous Quotidien/.✓ Copié

→ Liste de 5 à 7 chemins de fichiers
Lisez chacun

Lisez chaque note quotidienne et résumez par thème.✓ Copié

→ Puces thématiques, pas de concaténation brute
Écrivez la critique

Écrivez le résumé dans Reviews/2026-W16.md ; ajouter le statut du frontmatter : examen, balises : [hebdomadairement].✓ Copié

→ Nouveau fichier avec une introduction appropriée

Résultat : Une note de revue hebdomadaire construite à partir de la matière première sans copier-coller manuel.

Combiner avec : github

Consolider les balises désordonnées dans un coffre-fort

👤 Des coffres-forts qui ont connu une croissance organique et qui ont désormais des variantes #Work / #work / #WORK ⏱ ~30 min intermediate

Quand l'utiliser : La liste des balises est trop longue en raison de doublons et de quasi-doublons.

Déroulement

Liste des balises actuelles

Utilisez obsidian_manage_tags pour répertorier toutes les balises triées par utilisation.✓ Copié

→ Le nombre de balises fait apparaître les doublons
Proposer une cartographie

Proposer un ensemble canonique et une cartographie ancien → nouveau.✓ Copié

→ Petite table révisable
Appliquer par lots

Après avoir confirmé, renommez les balises dans le coffre-fort à l'aide du mappage.✓ Copié

→ Opérations de balise résumées par note

Résultat : Taxonomie de balises propre dans laquelle vous pouvez réellement naviguer.

Pièges

Réécriture de centaines de notes en une seule fois sans sauvegarde — Validez d'abord le coffre-fort sur git ; revoir la différence

Combiner avec : git

Déposez des coupures Web dans une boîte de réception de recherche et marquez-les automatiquement

👤 Chercheurs, analystes, toute personne ayant l'habitude de la tondeuse ⏱ ~15 min beginner

Quand l'utiliser : La boîte de réception/le dossier s’accumule plus rapidement que vous ne pouvez le traiter.

Prérequis

Une boîte de réception/un dossier désigné — Créez-le dans le coffre-fort

Déroulement

Boîte de réception de la liste

Répertoriez les notes non marquées sous Boîte de réception/.✓ Copié

→ Chemins des éléments en attente
Classer et étiqueter

Pour chacun, suggérez 1 à 3 balises en fonction du contenu, puis postulez avec obsidian_manage_tags.✓ Copié

→ Balises ajoutées atomiquement via frontmatter

Résultat : La boîte de réception reste petite ; les nouveaux clips sont organisés automatiquement.

Combiner avec : fetch

Combinaisons

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

obsidian-mcp-server + fetch

Découpez une URL avec fetch, puis écrivez-la dans la boîte de réception/

Récupérez https://... et enregistrez un résumé nettoyé dans Inbox/YYYY-MM-DD-title.md avec le texte approprié.✓ Copié

obsidian-mcp-server + github

Copiez les résumés de relations publiques fusionnés dans Projects/<repo>.md

Recherchez les PR fusionnés cette semaine et joignez un résumé sous ## Semaine 16 dans Projects/acme-api.md.✓ Copié

obsidian-mcp-server + git

Versionnez votre coffre-fort et validez les modifications par lots

Après le nettoyage des balises, exécutez git diff sur le coffre-fort et résumez avant de valider.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler
obsidian_read_note	path: str	Lire une note spécifique avant de la modifier ou de la résumer
obsidian_update_note	path: str, content: str, mode: 'append'\|'prepend'\|'overwrite'	Ajouter ou remplacer le contenu d'une note – ajout par défaut, sauf réécriture
obsidian_search_replace	path: str, find: str, replace: str	Modifications ciblées dans les notes sans régénérer l'intégralité du fichier
obsidian_global_search	query: str, filters?	Rechercher des notes dans tout le coffre-fort
obsidian_list_notes	folder?: str	Énumérer les notes dans un dossier avant les opérations par lots
obsidian_manage_frontmatter	path: str, op: 'get'\|'set'\|'delete', key?: str, value?: any	Changements atomiques au niveau clé
obsidian_manage_tags	path?: str, op: 'list'\|'add'\|'remove'	Opérations d’hygiène et de taxonomie des balises
obsidian_delete_note	path: str	Supprimer une note – permanent, pas d'annulation

Coût et limites

Coût d'exécution

Quota d'API: Aucune API externe – L'API REST locale s'exécute sur votre Mac/PC
Tokens par appel: Format note ; typique 200-3000
Monétaire: Gratuite
Astuce: Préférez global_search + lecture à la demande au lieu de répertorier en masse des dossiers entiers dans leur contexte.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : OBSIDIAN_API_KEY dans la variable d'environnement uniquement - jamais validé. Traitez-le comme un jeton d'administrateur local pour votre coffre-fort.

Sortie de données : Tout le trafic est localhost → API REST locale Obsidian. Aucun appel cloud depuis ce serveur.

Le plugin Local REST API expose votre coffre-fort sur un port HTTP local ; liez-vous à 127.0.0.1 uniquement et désactivez HTTPS uniquement pour localhost.
Un attaquant qui atteint votre OBSIDIAN_API_KEY obtient une lecture/écriture complète sur le coffre-fort – effectuez une rotation si vous soupçonnez une fuite.

Dépannage

Erreurs courantes et correctifs

ÉCONNREFUSÉ 127.0.0.1:27123

Obsidian ne fonctionne pas ou le plugin Local REST API est désactivé. Ouvrez Obsidian et activez le plugin.

Vérifier : curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/

401 Non autorisé

OBSIDIAN_API_KEY ne correspond pas à la clé actuelle du plugin. Copiez à nouveau la valeur des paramètres du plugin.

Vérifier : Plugin Settings → Local REST API → copy the API key

404 sur un fichier connu

Le chemin est relatif au coffre-fort et sensible à la casse – confirmez avec obsidian_list_notes.

Vérifier : obsidian_list_notes folder='Daily'

Alternatives

Obsidian MCP Server vs autres

Alternative	Quand l'utiliser	Compromis
obsidian-plugin-skill	Vous souhaitez que Claude aide à créer des plugins Obsidian, et non à modifier le contenu du coffre-fort	Portée différente
filesystem MCP	Vous êtes à l'aise avec les opérations sur les fichiers bruts et n'avez pas besoin d'API de frontmatter/tag prenant en charge Obsidian	Vous perdez les opérations de balise/frontmatter atomiques

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills