Skip to main content
Glama
obsidian-mcp-server

obsidian-mcp-server

by BartK1990

obsidian-mcp-server

Un plugin mínimo de Obsidian que ejecuta un servidor MCP (Model Context Protocol) dento del propío Obsidian, utilizando el transporte Streamable HTTP. Expone cutro herramientas: list_nots, read_note, write_note y search_notes.

Se ejecuta íntegramente en tu máquina (se vincula a 127.0.0.1) — ningún dato sale de tu PC a menos que apuntes un cliente remoto a él, cosa que no deberías hacer.

Por qué este enfoque

La aplicación de escritorio de Obsidian es Electron con integración de Node disponible para los plugins, por lo que el plugin puede abrir un http.Server real y hablar MCP directamente — sin proceso externo, sin un servidor npm separado que mantener en ejecución.

Related MCP server: obsidian-mcp

Compilar (Windows)

# 1. Put this folder inside your vault's plugin directory, e.g.:
#    <vault>\.obsidian\plugins\obsidian-mcp-server\

cd <vault>\.obsidian\plugins\obsidian-mcp-server
npm install
npm run build

Esto genera main.js junto a manifest.json. Luego en Obsidian: Ajustes → Plugins de la comunidad → activa "MCP Server". Deberías ver un aviso: MCP server listening on http://127.0.0.1:8123/mcp.

Abre los ajustes del plugin para cambiar el puerto o establecer un token de portador.

Conectar Claude Desktop

La configiración local mcpServers de Claude Desktop espera un comando stdio, no una URL directa, así que usa mcp-remote como puente hacia el endpoint HTTP (se instala bajo demanda con npx, necesita Node.js):

Edita %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:8123/mcp"]
    }
  }
}

Si estableces un token de portador en los ajustes del plugin, pásalo como cabecera:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "http://127.0.0.1:8123/mcp",
        "--header", "Authorization:Bearer YOUR_TOKEN"
      ]
    }
  }
}

Cierra Claude Desktop desde el icono de la bandeja y vuelve a abrirlo. Debería aparecer un icono de herramienta que muestre las cuatro herramientas de Obsidian.

Depuración

  • Usa el MCP Inspector para probar el servidor directamente, sin Claude Desktop: npx @modelcontextprotocol/inspector y conéctate a http://127.0.0.1:8123/mcp.

  • La consola de desarrollador de Obsidian (Ctrl+Shift+I) muestra la salida de console.error del plugin, incluidos los errores de solicitud.

Ampliación

Añade más herramientas en buildMcpServer() en main.ts — por ejemplo, envuelve app.metadataCache para consultas de frontmatter/etiquetas, o app.workspace para "qué nota está abierta actualmente". Cada herramienta es solo un nombre, un esquema de entrada zod y un manejador asíncrono que devuelve { content: [...] }.

Notas / advertencias

  • isDesktopOnly: true en el manifiesto — esto no se cargará en Obsidian móvil, ya que no hay un módulo http nativo allí.

  • El modo de transporte sin estado aquí (un StreamableHTTPServerTransport nuevo por solicitud) es la opción más sencilla y adecuada para un único cliente local. Si quieres varios clientes concurrentes con continuidad de sesión adecuada, añadirías un mapa de transportes con clave Mcp-Session-Id — consulta el ejemplo "with session management" del SDK de MCP TypeScript.

  • El token de portador es una comprobación básica de secreto compartido, no una autenticación real. Dado que el servidor solo se vincula a 127.0.0.1, el principal modelo de amenaza son "otros procesos locales de tu máquina", algo que el token sí aborda.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers