palace-mcp
palace-mcp
Servidor MCP que expone una bóveda de Obsidian a asistentes de IA mediante el plugin Local REST API.
Construido con FastMCP. Los agentes pueden listar, leer, escribir, buscar y eliminar notas — y leer la nota que esté abierta actualmente en Obsidian.
Requisitos previos
Obsidian con el plugin Local REST API instalado y en ejecución
Python 3.12+
uv (recomendado) o pip
Copia tu clave de API desde los ajustes del plugin en Obsidian antes de continuar.
Related MCP server: obsidian-local-mcp
Instalación
git clone <repo-url> palace-mcp
cd palace-mcp
uv syncConfiguración
Variable | Obligatorio | Por defecto | Descripción |
| sí | — | Token Bearer del plugin Local REST API |
| no |
| Host donde escucha la API REST de Obsidian |
| no |
| Puerto de la API REST |
| no |
|
|
| no |
| Rutas separadas por comas donde |
Al usar HTTPS con el certificado autofirmado del plugin, la verificación del certificado se omite automáticamente.
Ejecución
Inicia el servidor a través de stdio (el transporte predeterminado para clientes MCP):
export OBSIDIAN_API_KEY="your-api-key"
uv run python server.pyO mediante FastMCP:
uv run fastmcp run server.pyConfiguración de Cursor
Añade a tu configuración de MCP (p. ej. ~/.cursor/mcp.json):
{
"mcpServers": {
"obsidian-palace": {
"command": "uv",
"args": ["run", "python", "server.py"],
"cwd": "/path/to/palace-mcp",
"env": {
"OBSIDIAN_API_KEY": "your-api-key-here"
}
}
}
}Reinicia Cursor o recarga los servidores MCP después de guardar.
Herramientas
Herramienta | Descripción |
| Lista archivos y carpetas. Pasa una ruta de subdirectorio, o déjala vacía para la raíz de la bóveda. |
| Lee el contenido completo de una nota mediante su ruta relativa a la bóveda (p. ej. |
| Crea una nota nueva o sobrescribe una existente. |
| Añade texto al final de una nota. Crea la nota si no existe. |
| Búsqueda de texto completo; devuelve los nombres de archivo coincidentes ordenados por relevancia. |
| Devuelve el contenido de la nota actualmente abierta en Obsidian. |
| Elimina una nota permanentemente. Irreversible — úsalo con cuidado. |
Protección contra añadidos
Algunas rutas de la bóveda se tratan como solo sobrescritura. Añadir contenido a ellas puede acumular silenciosamente contenido duplicado dentro de una misma nota, lo que resulta difícil de detectar más adelante.
Por defecto, append_note se rechaza para rutas que coincidan con:
/Context/(cualquier nota dentro de una carpetaContext)/System/(cualquier nota dentro de una carpetaSystem)Index.md(cualquier archivo llamadoIndex.md)
En su lugar, usa write_note para reemplazar estas notas. Anula la lista de denegación con la variable de entorno PALACE_APPEND_DENY.
Licencia
MIT
Available Tools
7 toolsactive_noteA
Return the contents of the note currently open in Obsidian.
Inputs: no named parameters. Returns: result
append_noteA
Append text to the end of a note (creates the note if it doesn't exist).
Inputs: path (required), content (required). Returns: result
delete_noteA
Permanently delete a note. Use with care — this is irreversible.
Inputs: path (required). Returns: result
list_notesA
List files and folders. Pass a subdirectory path, or leave empty for the vault root.
Inputs: directory. Returns: result
read_noteA
Read a note's full contents by vault-relative path, e.g. 'People/Alice.md'.
Inputs: path (required). Returns: result
search_notesA
Full-text search the vault; returns matching filenames ranked by relevance.
Inputs: query (required). Returns: result
write_noteA
Create a new note or OVERWRITE an existing one at the given vault-relative path.
Inputs: path (required), content (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct file operation: listing, reading, writing, appending, searching, accessing the active note, and deleting. There is no meaningful overlap between tool purposes.
Most tools follow a clear verb_note pattern: read_note, write_note, append_note, delete_note, and search_notes. The deviations are minor: list_notes uses plural and active_note is adjective_noun, but the overall convention is still predictable.
Seven tools is a well-scoped set for an Obsidian vault server. Each tool covers a necessary note operation without unnecessary bloat.
The core note lifecycle is covered: list, read, write, append, search, and delete. Missing operations like rename, move, or folder management are minor gaps that agents can usually work around by writing to a new path.
Maintenance
Related MCP Connectors
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
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.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides an MCP server that allows AI assistants to interact with Obsidian vaults, enabling reading/writing notes, managing metadata, searching content, and working with daily notes.37MIT
- AlicenseNot gradedqualityDmaintenanceA local MCP server that wraps the Obsidian CLI to give AI assistants direct access to read, edit, and manage notes within an Obsidian vault. It enables advanced operations such as frontmatter property management, context-aware searching, and the execution of internal Obsidian commands.2MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI assistants to access and manage your local Obsidian vault through a standardized protocol.147,721 npm2Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA lightweight MCP server that enables AI assistants to securely read, create, and modify notes in an Obsidian vault, with support for semantic search and web scraping.7,721 npmMIT