Obsidian Local REST API

★ 2.635

Plugin communautaire qui démarre un serveur HTTPS local dans Obsidian — depuis 2026 avec un point de terminaison MCP intégré : lire/écrire des notes, rechercher dans le vault.

Obsidian Local REST API est un plugin communautaire qui démarre au lancement un serveur HTTPS local sur 127.0.0.1:27124 (certificat auto-signé ; en option, un serveur HTTP supplémentaire sur le port 27123, à activer séparément). Chaque requête est protégée par une clé API, disponible dans les paramètres du plugin et transmise comme token Bearer. Les points de terminaison REST permettent de lire, écrire, patcher et supprimer des notes (/vault/{path}), d'éditer le fichier actuellement ouvert (/active/), d'effectuer une recherche plein texte (/search/simple/), de mener des recherches de métadonnées plus complexes via JsonLogic (/search/), de lister les tags ou de déclencher des commandes Obsidian (/commands/).

Depuis 2026, le plugin intègre en plus un point de terminaison MCP sous /mcp/ (transport Streamable HTTP, même authentification que l'API REST), qui expose plus de 15 outils comme vault_read, vault_write ou search_query. Claude Code prend en charge HTTP-MCP nativement et peut se connecter directement à ce point de terminaison via une commande CLI — un processus de serveur MCP séparé n'est ainsi plus nécessaire. Claude Desktop ne parle pas nativement HTTP-MCP et a besoin, selon la documentation, d'un pont comme mcp-remote. Votre propre vault Obsidian devient ainsi une source de connaissances consultable et modifiable pour l'agent — le tout en local sur votre machine, sans que les données aient à en sortir.

🔧 SETUP

Installer et activer le plugin « Local REST API » via les plugins communautaires d'Obsidian
Dans Obsidian : ouvrir Settings → Local REST API, copier la clé API, faire confiance au certificat auto-signé si nécessaire
Tester l'accessibilité : GET https://127.0.0.1:27124/ renvoie un contrôle de statut sans authentification
Connecter Claude Code : `claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ --header "Authorization: Bearer <your-api-key>"`
Sinon, déclarer manuellement dans `.mcp.json` : `{"mcpServers":{"obsidian":{"type":"http","url":"https://127.0.0.1:27124/mcp/","headers":{"Authorization":"Bearer <your-api-key>"}}}}`

✅ QUAND L’UTILISER ?

Rechercher dans ses notes pendant qu'on code

Claude Code effectue une recherche plein texte dans votre vault Obsidian pour retrouver une ancienne décision d'architecture, pendant que vous travaillez précisément sur ce module.

Réécrire directement ses constats

Après une session de débogage, vous demandez à Claude d'écrire directement une nouvelle note de synthèse dans le vault (vault_write), sans ouvrir Obsidian vous-même.

⛔ QUAND ÉVITER ?

Aucun accès à distance

Le serveur ne tourne qu'en local sur 127.0.0.1 — Obsidian doit être ouvert avec le vault chargé sur la même machine, sinon le point de terminaison est inaccessible.

Mieux: Pour un accès depuis un autre appareil, mettre en place son propre tunnel/reverse proxy (hors périmètre du plugin) ou travailler directement sur la machine contenant le vault.

Claude Desktop nécessite une étape supplémentaire

Claude Desktop ne parle pas nativement HTTP-MCP ; selon la documentation, un proxy comme mcp-remote est nécessaire.

Mieux: Utiliser Claude Code (HTTP-MCP natif) ou configurer mcp-remote comme pont.