Skip to main content
Glama

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 sync

Configuración

Variable

Obligatorio

Por defecto

Descripción

OBSIDIAN_API_KEY

sí

—

Token Bearer del plugin Local REST API

OBSIDIAN_HOST

no

127.0.0.1

Host donde escucha la API REST de Obsidian

OBSIDIAN_PORT

no

27123

Puerto de la API REST

OBSIDIAN_PROTOCOL

no

http

http o https

PALACE_APPEND_DENY

no

/Context/,/System/,Index.md

Rutas separadas por comas donde append_note está bloqueado

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.py

O mediante FastMCP:

uv run fastmcp run server.py

Configuració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

list_notes

Lista archivos y carpetas. Pasa una ruta de subdirectorio, o déjala vacía para la raíz de la bóveda.

read_note

Lee el contenido completo de una nota mediante su ruta relativa a la bóveda (p. ej. People/Alice.md).

write_note

Crea una nota nueva o sobrescribe una existente.

append_note

Añade texto al final de una nota. Crea la nota si no existe.

search_notes

Búsqueda de texto completo; devuelve los nombres de archivo coincidentes ordenados por relevancia.

active_note

Devuelve el contenido de la nota actualmente abierta en Obsidian.

delete_note

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 carpeta Context)

  • /System/ (cualquier nota dentro de una carpeta System)

  • Index.md (cualquier archivo llamado Index.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 tools
active_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

    A4.1/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    Seven tools is a well-scoped set for an Obsidian vault server. Each tool covers a necessary note operation without unnecessary bloat.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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.
      37
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      MIT