Mejor servidor MCP de Obsidian para Claude: configuración y opciones

Claude es muy listo, pero nunca ha visto tus notas. Pregúntale por las notas de la reunión del trimestre pasado o por el ensayo a medio escribir que está enterrado en tu vault, y solo podrá adivinar. Un servidor MCP de Obsidian cierra esa brecha. Abre una puerta controlada a tus archivos markdown, para que Claude pueda buscar, leer y escribir notas mientras tú sigues al mando de lo que toca.

El problema es la elección. Existen más de una docena de servidores, y los nombres de los paquetes, los plugins y los puertos cambiaron mucho durante 2026. Este artículo aclara qué servidor merece tu tiempo, recorre la configuración exacta para Claude Desktop y Claude Code, y señala los errores que hacen perder una tarde. La respuesta corta: elige mcpvault para un inicio rápido sin plugin, y pasa a un servidor basado en REST, como obsidian-mcp-server de cyanheads, cuando quieras que Obsidian participe directamente.

💡 Veredicto rápido: ¿No necesitas plugin ni tener la app abierta? Usa un servidor de sistema de archivos. ¿Quieres la nota activa, los comandos y las notas periódicas? Usa un servidor de Local REST API.

Qué hace un servidor MCP de Obsidian

MCP significa Model Context Protocol, el estándar abierto que Anthropic presentó para que las aplicaciones de IA puedan acceder a herramientas externas mediante pequeños programas llamados servidores. Un servidor MCP de Obsidian es uno de esos programas. Se sitúa entre Claude y tu vault, una carpeta sencilla de archivos markdown, y expone una lista corta de herramientas: listar archivos, leer una nota, buscar, añadir texto, editar una sección y, en algunos servidores, mover o eliminar notas.

Cómo lee Claude tu vault

Cuando haces una pregunta, Claude decide si una llamada a una herramienta le ayudaría. Escribe "busca mis notas sobre el experimento de precios" y llamará a la herramienta de búsqueda, recibirá rutas de archivos y fragmentos, y después llamará a la herramienta de lectura con las coincidencias más relevantes. El servidor se ejecuta en tu propio equipo, y Claude Desktop te pide permiso antes de usar una herramienta.

Hay algo que conviene tener en cuenta: cualquier nota que Claude lea pasa a formar parte de la conversación, lo que significa que ese texto se envía a Anthropic para su procesamiento. Mantén fuera de la carpeta expuesta el material realmente privado.

Sistema de archivos frente a Local REST API

Todos los servidores de Obsidian encajan en uno de dos diseños, y la elección condiciona todo lo demás:

• Los servidores de sistema de archivos leen y escriben los archivos .md directamente. Solo necesitan la ruta del vault, funcionan con Obsidian cerrado y se instalan en una línea. No pueden ver el estado en vivo de Obsidian, como qué nota está abierta.
• Los servidores de Local REST API se comunican con Obsidian a través del plugin de la comunidad llamado Local REST API. Pueden acceder a la nota activa, ejecutar comandos de Obsidian y usar notas periódicas, pero Obsidian debe estar en marcha y tienes que proporcionar un token del plugin.

Los mejores servidores comparados

Los directorios cambian cada semana, así que dejo a un lado el número de estrellas y comparo lo que realmente afecta a tu configuración. Revisa el README de cada proyecto antes de copiar un comando, porque varios proyectos renombraron paquetes o publicaron versiones con cambios incompatibles este año.

Vista comparativa

💡 Trampa de nombres: el paquete de npm que antes se llamaba mcp-obsidian se renombró como @bitbonsai/mcpvault a principios de 2026. Los tutoriales antiguos que usan el nombre anterior pueden llevarte al paquete equivocado, así que copia los nombres del README actual.

mcpvault para una configuración sencilla

mcpvault es el camino más corto de cero a una conexión funcional con tu vault. Pasas un argumento, la ruta del vault, y lee los archivos directamente. Si omites la ruta, usa el directorio de trabajo actual, lo que resulta práctico cuando abres Claude Code desde dentro del vault. Sus herramientas gestionan la lectura y escritura de notas, las ediciones tipo parche, la búsqueda, el frontmatter y las etiquetas, aunque el README recoge la lista actualizada.

Como nunca toca la API propia de Obsidian, la app puede seguir cerrada, y sigue siendo rápido con un vault de miles de notas. La contrapartida es que no puede ejecutar comandos de Obsidian ni saber qué nota estás viendo.

cyanheads para uso intensivo

obsidian-mcp-server de cyanheads está escrito en TypeScript y se conecta a través del plugin Local REST API. Fue el que más descargas semanales tuvo en npm según los directorios que consulté, y una versión reciente lo adaptó a la versión 4 del plugin. Su README incluye búsqueda global, búsqueda y reemplazo dentro de una nota, y gestión de frontmatter y etiquetas.

Elígelo cuando Claude sea un compañero diario y no un experimento. A cambio de esa profundidad, añades una pieza más que mantener: el plugin, su token y una ventana de Obsidian en ejecución.

Servidores REST para funciones en vivo

mcp-obsidian de MarkusPfundstein es la opción de Python. Lo lanzas con uvx, y se comunica con el plugin en 127.0.0.1 por el puerto HTTPS 27124. Sus herramientas incluyen búsqueda, añadir contenido a una nota y modificar contenido bajo un encabezado concreto. El proyecto estuvo parado mucho tiempo antes de que su mantenedor volviera en mayo de 2026, así que revisa los commits recientes antes de decidirte.

Hay dos más que merecen un vistazo. Obsidian MCP Tools se instala desde dentro de Obsidian y añade búsqueda semántica mediante Smart Connections, además de compatibilidad con Templater. Y las versiones recientes de Local REST API incluyen un endpoint MCP integrado, lo que significa que quizá puedas apuntar a Claude directamente al plugin, sin ningún programa de Node o Python de por medio. Consulta las notas de la versión del plugin para ver la dirección exacta.

Mi elección según tu situación:

1. Quieres que funcione en cinco minutos: mcpvault.
2. Usas Obsidian todo el día y quieres herramientas completas: cyanheads.
3. Ya trabajas con herramientas de Python: mcp-obsidian.
4. Quieres el menor número de programas instalados: el endpoint integrado del plugin, si tu versión lo incluye.

Configuración para Claude Desktop

Antes de tocar ninguna configuración, comprueba tres cosas. Node.js (la versión LTS actual) está instalado si vas a usar un servidor npx, o uv si vas a usar uvx. Claude Desktop está instalado y has iniciado sesión. Y conoces la ruta absoluta a tu vault, por ejemplo /Users/you/Documents/MyVault o C:\Users\you\Documents\MyVault.

Para un servidor REST también necesitas el plugin. En Obsidian abre Ajustes, Complementos de la comunidad, Explorar, busca Local REST API, instálalo y actívalo, y luego copia el token que aparece en su página de ajustes. El plugin escucha en el puerto HTTPS 27124 con un certificado autofirmado. Existe un puerto HTTP, el 27123, pero viene desactivado por defecto.

Edita el archivo de configuración

En Claude Desktop abre Ajustes, después Desarrollador, y luego Editar configuración. Eso abre claude_desktop_config.json, que se encuentra en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows. Añade mcpvault así:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["@bitbonsai/mcpvault@latest", "/Users/you/Documents/MyVault"]
    }
  }
}

Copiar prompt

En Windows, duplica las barras invertidas de la ruta: "C:\\Users\\you\\Documents\\MyVault". Guarda el archivo, cierra Claude Desktop por completo (desde la barra de menús o la bandeja del sistema, no solo la ventana) y vuelve a abrirlo. El icono de herramientas del cuadro de chat debería mostrar ahora las herramientas de Obsidian.

💡 Consejo sobre PATH: Claude Desktop no hereda el PATH de tu terminal. Si el servidor no arranca, sustituye npx por la ruta absoluta que muestra which npx en macOS o where npx en Windows.

Conecta un servidor REST

Un servidor REST usa el mismo archivo con una entrada distinta. Esta es la estructura para mcp-obsidian:

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Copiar prompt

Añade una entrada más a ese bloque env: el token de tu plugin, bajo el nombre exacto de variable que indica el README del servidor. Los nombres cambian entre proyectos, por eso no voy a adivinar uno aquí. Mantén Obsidian abierto mientras chateas, porque el servidor accede a tu vault a través del plugin.

Configuración para Claude Code

Claude Code añade los servidores desde la terminal, sin editar JSON.

Instalación con un solo comando

Para mcpvault:

claude mcp add obsidian --scope user -- npx @bitbonsai/mcpvault@latest /path/to/vault

Copiar prompt

La marca --scope user hace que el servidor esté disponible en todos los proyectos. El ámbito local predeterminado lo limita al proyecto actual, y el ámbito de proyecto escribe un archivo .mcp.json que quizá quieras subir a git. Nunca pongas un token en un .mcp.json compartido.

Para un servidor REST, pasa los valores de entorno con -e:

claude mcp add obsidian --scope user -e OBSIDIAN_HOST=127.0.0.1 -e OBSIDIAN_PORT=27124 -- uvx mcp-obsidian

Copiar prompt

Añade el token del plugin de la misma forma, usando el nombre de variable que indica el README.

Comprueba y prueba con prompts

Ejecuta claude mcp list para ver si el servidor aparece como conectado, o escribe /mcp dentro de una sesión. Después prueba prompts que demuestren que cada herramienta funciona:

• "Lista las diez notas modificadas más recientemente y resume cada una en una línea."
• "Busca notas que mencionen el experimento de precios y redacta una actualización de estado a partir de ellas."
• "Añade las tres decisiones de hoy a mi nota diaria bajo un encabezado llamado Decisiones."
• "Encuentra notas que mencionen a una persona por su nombre pero que nunca enlacen a su página."

Los equipos pueden compartir un vault mediante una carpeta sincronizada, y cada persona añade el servidor en su propio equipo. Limita el acceso de escritura a quienes lo necesiten.

Hábitos seguros antes de dar acceso de escritura

El acceso de lectura tiene poco riesgo. El de escritura no, porque una sola instrucción mal interpretada puede sobrescribir una nota o borrar un archivo. Unos pocos hábitos eliminan la mayor parte del peligro.

Haz copias de seguridad primero

Convierte el vault en un repositorio git con el plugin Obsidian Git, confirma que el historial de versiones de Obsidian Sync está activado o, como mínimo, copia la carpeta en un segundo disco. Después prueba a restaurar una vez. Una copia de seguridad que nunca has restaurado es una esperanza, no una copia de seguridad.

Aprueba las herramientas de escritura y borrado una llamada cada vez hasta que confíes en su comportamiento. Lee el cambio propuesto antes de hacer clic en Permitir.

Limita lo que Claude puede tocar

Los servidores de sistema de archivos aceptan cualquier ruta de carpeta, así que apúntalos a una subcarpeta dedicada en lugar de a todo el vault. Mantén los diarios y los borradores privados fuera de ella. Guarda los tokens solo en tu configuración local, nunca en un repositorio.

Cómo corregir los fallos de configuración habituales

La mayoría de los primeros intentos fallan por motivos sencillos. Revísalos en este orden.

El servidor aparece como fallido

• Falta Node o uv. Ejecuta node --version o uv --version en una terminal.
• PATH incorrecto. Usa la ruta absoluta a npx o uvx en la configuración.
• Nombre de paquete antiguo. Sustituye mcp-obsidian en npm por @bitbonsai/mcpvault.
• JSON roto. Busca una coma final, unas comillas que falten o barras invertidas simples en una ruta de Windows.
• App desactualizada. Cierra Claude Desktop por completo y vuelve a abrirlo.

Si nada ayuda, abre los archivos de registro de MCP. En macOS están en ~/Library/Logs/Claude/, y en Windows en %APPDATA%\Claude\logs. Las últimas líneas suelen indicar el problema exacto.

Errores de puerto y certificado

Los servidores REST añaden sus propios fallos. Obsidian debe estar en marcha con el plugin activado. Una respuesta 401 o 403 significa que el token no coincide, así que cópialo de nuevo sin espacio al final. Un error de certificado en el puerto 27124 procede del certificado autofirmado del plugin: sigue las instrucciones del README del servidor para confiar en él, o activa el puerto HTTP 27123 en los ajustes del plugin y úsalo solo en localhost. Si otro programa ocupa el puerto, cámbialo tanto en el plugin como en tu bloque env.

Redacta notas con Claude en PicassoIA

MCP vive dentro de Claude Desktop y Claude Code, así que una herramienta del navegador no puede sustituirlo. Lo que PicassoIA aporta es la otra mitad del trabajo: redactar y limpiar el texto antes de que llegue a tu vault, sin instalar nada. Claude Sonnet 5 encaja bien, y Claude Opus 4.7 y Claude 4.5 Haiku cubren tareas más pesadas y más ligeras.

Cómo usar Claude Sonnet 5 en PicassoIA:

1. Abre la página de Claude Sonnet 5.
2. Pega tu material en bruto en Prompt: una transcripción aproximada, viñetas sueltas o un volcado de investigación desordenado. Después indica el formato de nota que quieres.
3. Rellena System Prompt una sola vez con las convenciones de tu vault, como frontmatter en YAML, wikilinks para las personas y tu estilo de encabezados.
4. Elige un nivel de Effort y ejecútalo.
5. Copia el resultado en Obsidian o pásaselo a tu Claude conectado por MCP para que lo archive en la carpeta correcta.

💡 El campo de imagen resulta útil para la investigación: fotografía una pizarra, deja que Claude la convierta en una nota estructurada y archívala en tu vault.

Crea tus propias imágenes en Picasso IA

Un vault lleno de texto se vuelve más fácil de escanear cuando las notas incluyen una imagen. Una foto de cabecera para la nota de un proyecto, un tablero de inspiración para un briefing de diseño o una escena fotorrealista para el borrador de un relato: cada una requiere un prompt breve y unos segundos en Picasso IA.

Prueba Seedream 4.5 para escenas detalladas y pulidas, GPT Image 2 cuando el prompt sea largo y concreto, FLUX 2 Pro para fotografía realista y nítida, o P-Image cuando quieras resultados rápidos. Describe el sujeto, la luz y el objetivo, y mantén la redacción tan concreta como la lista de tomas de un fotógrafo.

Configura tu servidor MCP de Obsidian esta semana, luego abre Picasso IA y crea la primera imagen para tu propio vault. Experimenta con varios prompts, conserva los que encajen con tus notas y construye un hábito visual junto al escrito.