obsidian-mcp

Proporciona a Claude (y a cualquier cliente MCP) acceso de agente real a tu bóveda de Obsidian: recorrido de grafos, consultas de Dataview, conocimiento de notas diarias y más.

Instalación · Herramientas · Prompts para probar · Cómo se compara · Preguntas frecuentes

La mayoría de los servidores MCP de Obsidian exponen read_file y write_file y ahí terminan. Este trata tu bóveda como un grafo de conocimiento: tu LLM obtiene enlaces inversos, enlaces directos, consultas de Dataview, notas diarias y recorrido de grafos de múltiples saltos en una sola llamada.

Por qué

Abriste Claude Desktop, le pediste que encontrara conexiones en tus notas y lo viste usar read_file a través de tu bóveda, nota por nota. Así no es como los usuarios de Obsidian piensan realmente en sus notas. El grafo es el valor: enlaces inversos, conexiones transitivas, etiquetas, metadatos tipados de Dataview. Este servidor expone todo esto como herramientas de primera clase.

Instalación

Necesitas el plugin Local REST API en Obsidian. Instálalo desde los Plugins de la comunidad, actívalo y copia la clave API de su configuración.

Claude Desktop

Añade esto a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp"],
      "env": {
        "OBSIDIAN_API_KEY": "paste-your-key-here"
      }
    }
  }
}

Reinicia Claude Desktop. Ya está.

Claude Code

claude mcp add obsidian -e OBSIDIAN_API_KEY=paste-your-key-here -- npx -y obsidian-mcp

Cursor / Cline / Continue / Zed

Cualquier cliente compatible con MCP funciona. Apúntalo a npx -y obsidian-mcp con OBSIDIAN_API_KEY en el entorno.

Desde el código fuente

git clone https://github.com/yanxue06/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run build
OBSIDIAN_API_KEY=... node dist/index.js

Prompts para probar

Prueba estos en Claude Desktop con el servidor conectado:

Créame un Mapa de Contenido (MOC) para todo lo que he escrito sobre sistemas distribuidos. Usa traverse_graph desde "Distributed systems.md" con una profundidad de 2, luego agrupa los vecinos temáticamente y escribe el MOC en MOCs/Distributed systems MOC.md.

Encuentra todas las notas etiquetadas con #project donde status != "done" y la fecha de vencimiento sea esta semana. Usa query_dataview.

¿Qué hay en mi nota diaria de hoy? ¿Hay algo que olvidé seguir de la nota de ayer?

Encuentra todas mis notas huérfanas en Inbox/. Para cada una, sugiere dónde pertenece según su contenido y las etiquetas existentes.

Voy a renombrar "Atomic notes.md" a "Evergreen notes.md". Encuentra todas las notas que enlazan a ella y dime cuáles tendría que actualizar.

Recorre el grafo 2 saltos desde "Working memory.md" y dime qué notas son las más centrales para mi pensamiento sobre la atención.

Herramientas

15 herramientas en total. Las diferenciadas están en negrita.

Lectura

Búsqueda y grafo

Escritura

Cómo se compara

Configuración

Toda la configuración se realiza mediante variables de entorno: establécelas en la configuración de tu cliente MCP.

Cómo funciona

┌──────────────┐     stdio (MCP)      ┌──────────────┐    HTTPS     ┌──────────────────┐
│ Claude / IDE │ ───────────────────► │ obsidian-mcp │ ───────────► │  Local REST API  │ ──► Vault
└──────────────┘                      └──────────────┘              │ (Obsidian plugin)│
                                                                    └──────────────────┘

obsidian-mcp es una capa ligera sobre el plugin Local REST API. El plugin ejecuta un servidor HTTPS dentro de Obsidian con acceso total a la bóveda; este servidor adapta esa superficie al protocolo MCP y añade herramientas conscientes del grafo que la API REST de Obsidian no expone directamente (enlaces inversos, recorrido de múltiples saltos, detección de huérfanos).

Todo es local. Ningún dato sale de tu máquina excepto las solicitudes que tu cliente MCP hace a su proveedor de modelos, y tú controlas eso.

Preguntas frecuentes

¿Necesito instalar un plugin de Obsidian? Sí, el plugin Local REST API. Es la única forma sensata de hablar con una bóveda en ejecución desde fuera. Una vez instalado, obsidian-mcp se ejecuta como un proceso de Node separado iniciado por tu cliente MCP; no instalas otro plugin en Obsidian para esto.

¿Funciona si Obsidian está cerrado? No. El Local REST API se ejecuta dentro de Obsidian, por lo que la aplicación debe estar abierta.

¿Admite múltiples bóvedas? Una instancia del servidor apunta a una instancia de Obsidian en ejecución. Ejecuta múltiples entradas de servidor MCP (diferentes nombres + diferentes puertos) si cambias de bóveda con frecuencia.

¿Por qué HTTPS por defecto con OBSIDIAN_VERIFY_TLS=false? El plugin incluye un certificado autofirmado. El tráfico es solo de bucle local (127.0.0.1), por lo que la verificación añade fricción sin una ganancia de seguridad real. Si has reemplazado el certificado, activa la bandera.

¿Es seguro? El servidor MCP le da al modelo cualquier acceso que la clave API otorgue. Cualquier cosa que el modelo esté dispuesto a borrar, puede borrarla. Trátalo como cualquier agente con acceso de escritura a archivos: revisa lo que está a punto de hacer, especialmente antes de operaciones masivas.

Hoja de ruta

• [ ] Búsqueda semántica basada en embeddings (actualmente solo por palabras clave a través del plugin)

• [ ] Cambio de espacio de trabajo / enrutamiento de múltiples bóvedas

• [ ] Modo seguro de solo lectura (sin herramientas de escritura registradas)

• [ ] Suscripciones a recursos (actualizaciones push cuando cambian las notas)

• [ ] Envío al registro de Smithery / mcp-get

Las PR son bienvenidas. Consulta CONTRIBUTING.md.

Agradecimientos

• Local REST API de @coddingtonbear: todo este proyecto es derivado de él.

• El equipo del Model Context Protocol en Anthropic.

Licencia

MIT: consulta LICENSE.