obsidian-mcp-server
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 buildEsto 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/inspectory conéctate ahttp://127.0.0.1:8123/mcp.La consola de desarrollador de Obsidian (Ctrl+Shift+I) muestra la salida de
console.errordel 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: trueen el manifiesto — esto no se cargará en Obsidian móvil, ya que no hay un módulohttpnativo allí.El modo de transporte sin estado aquí (un
StreamableHTTPServerTransportnuevo 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 claveMcp-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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes Obsidian vault operations over HTTP via the Obsidian CLI, enabling note management, search, and daily note operations.1-
- AlicenseAqualityDmaintenanceEnables MCP-compatible AI hosts to read, search, link, and write notes in a local Obsidian vault with sandboxed file access.11MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes an Obsidian vault (search, read, create, and update notes) via Streamable HTTP.-
- AlicenseNot gradedqualityDmaintenanceMCP server for interacting with Obsidian via the Local REST API, enabling file operations, search, and content editing in your vault.MIT