MCP de Obsidian

npx -y obsidian-mcp /ruta/a/tu/boveda

La idea es tener un “segundo cerebro” funcional: toda tu información ordenada en Obsidian y un agente con acceso real a ella. En vez de pegar contexto en cada chat (“recuerda que el cliente X factura mensual, que el proyecto Y está parado desde marzo, que en la reunión del lunes acordamos esto”), el agente lo lee directamente de tu bóveda. Es la diferencia entre tener un asistente que se entera de todo de cero en cada conversación y uno que ya conoce tu mundo.

Obsidian, además, juega muy a favor: las notas son archivos .md de texto plano en una carpeta local. No hay base de datos opaca ni servicio remoto que se interponga. Tus datos siguen siendo tuyos, en tu disco, y el MCP se limita a leerlos y escribir ahí mismo cuando se lo pides. Para quien trabaja con información sensible (clientes, contratos, finanzas personales), esa garantía importa.

Que sea un MCP y no una integración directa también tiene su gracia: cualquier cliente compatible (Claude Desktop, Claude Code, Cursor, VS Code) puede usar el mismo servidor sobre la misma bóveda. Cambias de herramienta, pero el segundo cerebro se queda quieto.

Qué te abre

La búsqueda es la función estrella. Cualquier servidor de Obsidian para MCP expone alguna forma de buscar en todas tus notas (por palabra, por fragmento, por etiqueta) y de devolverle al agente los pasajes relevantes. Eso significa que puedes preguntar “qué sé del cliente X” y obtener una síntesis basada en notas reales, no en lo que la IA imagina.

La lectura puntual le permite al agente abrir notas concretas cuando ya sabe dónde mirar: el acta de la reunión del lunes, el contrato vigente, la propuesta que enviaste el mes pasado. Combinado con búsqueda, el flujo natural es “encuentra lo relevante, ábrelo entero, trabaja sobre ello”.

La escritura cambia la categoría del MCP. El agente puede crear notas nuevas (una propuesta a partir de tus plantillas, un resumen de reunión, un brief para un proyecto) y modificar las existentes (añadir conclusiones, completar plantillas, fusionar fragmentos sueltos en una nota consolidada). Como Obsidian es texto plano, el resultado se ve igual de bien en la app que en cualquier editor.

Algunos servidores van más allá y exponen funciones específicas de Obsidian: navegar por enlaces internos, leer y escribir el frontmatter YAML de cada nota, consultar el grafo o usar las etiquetas. Eso convierte al agente en alguien que entiende el sistema, no solo el texto. Si tu bóveda tiene plantillas, dataview o un esquema de etiquetas serio, conviene elegir un servidor que las respete.

Por debajo de todo, lo que ganas es contexto persistente. El agente deja de ser un chat aislado y pasa a ser una capa sobre tu base de conocimiento. La próxima vez que le preguntes algo, parte de lo que ya sabes.

Cómo conectarlo

Antes de tocar nada de MCP, ten Obsidian funcionando con una bóveda razonable. Si vienes de empezar, organiza un esquema mínimo: una carpeta Clientes/, otra Proyectos/, otra Reuniones/, otra Ideas/. No hace falta más para empezar; con esa estructura ya hay suficiente para que el agente entienda dónde está cada cosa.

Después elige un servidor MCP. Hay varios y no todos hacen lo mismo. En el frontmatter de esta ficha tienes tres opciones: StevenStavrakis/obsidian-mcp (acceso directo a los archivos .md), jacksteamdev/obsidian-mcp-tools (más herramientas, más complejidad) y cyanheads/obsidian-mcp-server (vía el plugin community “Local REST API”). La diferencia importante es cómo llegan a la bóveda. Los primeros leen los archivos del disco directamente, así que solo necesitan saber la ruta. El tercero requiere instalar el plugin “Local REST API” dentro de Obsidian, generar una clave y dejar Obsidian corriendo para que el servidor le hable por HTTP local. Esto último es más seguro y permite que Obsidian gestione la coherencia (índice, enlaces), pero pide unos pasos extra.

El ejemploConfig que ves en el frontmatter es la versión más simple: npx -y obsidian-mcp /ruta/a/tu/boveda. Sustituye /ruta/a/tu/boveda por la ruta absoluta real (en Mac suele ser algo como /Users/tu-usuario/Documentos/MiBoveda; en Windows, C:\\Users\\tu-usuario\\Documentos\\MiBoveda con dobles barras). Pega el bloque dentro de mcpServers en tu cliente, guarda y reinicia.

Si eliges el camino del plugin “Local REST API”, el README del servidor concreto que uses te explica los pasos exactos: instalar el plugin community, activarlo, generar la API key, copiarla a la configuración del MCP y arrancar el servidor. Trata esa API key como una contraseña.

Una vez todo conectado, lanza una prueba sencilla (“busca en mis notas la palabra X”). Si el agente devuelve resultados reales de tu bóveda, todo va bien. Si te dice que no tiene acceso o no encuentra nada, revisa primero la ruta y los permisos.

Seguridad y permisos

Cuando conectas este MCP estás dándole al agente acceso de lectura (y, si lo permites, de escritura) a toda tu bóveda. Eso incluye notas viejas, borradores, ideas a medio cocinar y, dependiendo de cómo trabajes, información sensible de clientes. Antes de conectar nada, piensa qué hay en esa carpeta y si te sientes cómodo con que un agente lo lea.

Si tu bóveda mezcla cosas profesionales y personales, considera tener bóvedas separadas y conectar solo la profesional. Si vas a probar el flujo por primera vez, trabaja sobre una copia de unas cuantas notas, no sobre la bóveda real, hasta entender qué hace el agente. Y si el servidor que eliges usa una API key (caso del plugin “Local REST API”), tratala como secreto: no la pegues en repos, no la mandes por chat, y si se filtra, regenérala desde el plugin.

Casos de uso reales

Una freelance que lleva 20 clientes en Obsidian le pide al agente cada lunes “revisa la carpeta Clientes/ y dime quién tiene tareas pendientes esta semana”. El agente cruza notas, plazos y compromisos, y le devuelve la lista priorizada antes del café.

Un consultor que toma notas en cada reunión le dice “lee las actas de las últimas tres reuniones con el cliente X en Reuniones/ y prepárame un brief para la propuesta que tengo que escribir”. El agente extrae acuerdos, problemas y oportunidades, y le entrega la base del documento.

Una desarrolladora indie usa la bóveda como diario técnico: ideas, decisiones de arquitectura, notas de bugs raros. Le pregunta “¿cuándo decidí cambiar de stack y por qué?” y el agente le encuentra la nota exacta de hace cuatro meses, con el contexto que ella ya no recordaba.

Errores comunes y cómo evitarlos

• La ruta no es absoluta. El servidor necesita la ruta completa, no ~/Documentos/MiBoveda ni una relativa. En Windows, además, con barras dobles.
• Bóveda con miles de notas y servidor sin índice. Algunos servidores se ralentizan si la bóveda es muy grande. Si las búsquedas tardan, considera el servidor vía “Local REST API”, que aprovecha el índice de Obsidian.
• Obsidian cerrado cuando el servidor lo necesita. En el flujo con plugin REST API, Obsidian tiene que estar abierto para que el servidor pueda hablarle. Si Obsidian no corre, el MCP no devuelve nada.
• API key del plugin filtrada. Si pegaste la API key del “Local REST API” en sitios públicos, regénerala desde el plugin. Mientras tanto, ese acceso queda comprometido.
• El agente “no ve” notas nuevas. Algunos servidores cachean. Tras crear notas nuevas, dale un momento y vuelve a buscar; si persiste, reinicia el servidor.
• Mezclar el MCP con sincronización. Si Obsidian Sync, iCloud o similar está moviendo archivos en paralelo, puede haber conflictos al escribir. Apaga la sincronización mientras el agente trabaja en lotes grandes.

Combinarlo con otros MCPs y skills

Obsidian se lleva bien con casi todo, porque hace de memoria. Junto al MCP de filesystem te permite “el agente lee notas y escribe el entregable final como .docx en otra carpeta”. Junto a Firecrawl, “extrae estos artículos y guarda los resúmenes como notas en Investigación/”. Junto al MCP de GitHub, “lee mis notas de bugs y abre los issues correspondientes en el repo”. El patrón general es el mismo: Obsidian es el contexto, los demás MCPs son las herramientas que actúan sobre él.

Mini-ejercicio

Monta una bóveda pequeña con cinco o seis notas reales (una por cliente o por proyecto). Conecta el MCP siguiendo el README del servidor que elijas y pide al agente “lee mis notas y dame en tres frases qué proyectos tengo activos ahora mismo”. Sabrás que está bien si la respuesta usa nombres y detalles concretos de tus notas, no afirmaciones genéricas.

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "/ruta/a/tu/boveda"]
    }
  }
}