Obsidian Local REST API

★ 2.635

Plugin de la comunidad que inicia un servidor HTTPS local dentro de Obsidian — desde 2026 con un endpoint MCP integrado: leer/escribir notas, buscar en el vault.

Obsidian Local REST API es un plugin de la comunidad que, al arrancar, levanta un servidor HTTPS local en 127.0.0.1:27124 (certificado autofirmado; opcionalmente también HTTP en el puerto 27123, que hay que activar aparte). Cada solicitud se protege con una clave de API que encuentras en los ajustes del plugin y se envía como token bearer. A través de endpoints REST se pueden leer, escribir, aplicar patches y eliminar notas (/vault/{path}), editar el archivo actualmente abierto (/active/), hacer búsqueda de texto completo (/search/simple/), realizar búsquedas de metadatos más complejas con JsonLogic (/search/), listar etiquetas o ejecutar comandos de Obsidian (/commands/).

Desde 2026, el plugin incorpora además un endpoint MCP integrado en /mcp/ (transporte HTTP streamable, misma autenticación que la API REST), que ofrece más de 15 herramientas como vault_read, vault_write o search_query. Claude Code es compatible de forma nativa con HTTP MCP y se puede conectar directamente a este endpoint mediante un comando de la CLI — ya no hace falta un proceso de servidor MCP aparte. Claude Desktop no habla HTTP MCP de forma nativa y, según la documentación, necesita para ello un puente como mcp-remote. Así, tu propio vault de Obsidian se convierte en una fuente de conocimiento navegable y editable para el agente — todo en local, en tu propio equipo, sin que los datos tengan que salir de él.

🔧 SETUP

Instalar y activar el plugin "Local REST API" a través de Obsidian Community Plugins
En Obsidian: abrir Settings → Local REST API, copiar la clave de API y, si hace falta, confiar en el certificado autofirmado
Probar la accesibilidad: GET https://127.0.0.1:27124/ devuelve una comprobación de estado sin autenticación
Conectar Claude Code: `claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ --header "Authorization: Bearer <your-api-key>"`
Alternativamente, introducirlo manualmente en `.mcp.json`: `{"mcpServers":{"obsidian":{"type":"http","url":"https://127.0.0.1:27124/mcp/","headers":{"Authorization":"Bearer <your-api-key>"}}}}`

✅ ¿CUÁNDO USARLO?

Buscar en las notas mientras se programa

Claude Code busca en tu vault de Obsidian por texto completo una antigua decisión de arquitectura mientras trabajas justo en ese módulo.

Guardar hallazgos directamente en las notas

Después de una sesión de depuración, haces que Claude escriba una nueva nota con un resumen directamente en el vault (vault_write), sin abrir Obsidian tú mismo.

⛔ ¿CUÁNDO MEJOR NO?

Sin acceso remoto

El servidor solo funciona en local en 127.0.0.1 — Obsidian debe estar en ejecución con el vault abierto en la misma máquina, de lo contrario el endpoint no es accesible.

Mejor: Para acceder desde otro dispositivo, configurar un túnel/proxy inverso propio (no forma parte del plugin) o trabajar directamente en la máquina con el vault.

Claude Desktop necesita un paso adicional

Claude Desktop no habla HTTP MCP de forma nativa; según la documentación, para eso hace falta un proxy como mcp-remote.

Mejor: Usar Claude Code (HTTP MCP nativo) o configurar mcp-remote como puente.