Servidor MCP para Obsidian

Servidor MCP para interactuar con Obsidian a través del complemento de la comunidad API REST local.

Componentes

Herramientas

El servidor implementa múltiples herramientas para interactuar con Obsidian:

list_files_in_vault: enumera todos los archivos y directorios en el directorio raíz de su bóveda de Obsidian
list_files_in_dir: enumera todos los archivos y directorios en un directorio específico de Obsidian
get_file_contents: Devuelve el contenido de un solo archivo en su bóveda.
Buscar: busca documentos que coincidan con una consulta de texto específica en todos los archivos del almacén.
patch_content: Inserta contenido en una nota existente relativa a un encabezado, referencia de bloque o campo frontmatter.
append_content: agrega contenido a un archivo nuevo o existente en el almacén.
delete_file: elimina un archivo o directorio de tu bóveda.

Ejemplos de indicaciones

Es bueno indicarle primero a Claude que use Obsidian. Así, siempre llamará a la herramienta.

El uso indica lo siguiente:

Obtenga el contenido de la última nota de llamada de arquitectura y resúmalo
Busque todos los archivos donde se menciona Azure CosmosDb y explíqueme rápidamente el contexto en el que se menciona
Resume las notas de la última reunión y guárdalas en una nueva nota llamada "resumenreunión.md". Añade una introducción para que pueda enviarla por correo electrónico.

Configuración

Clave API REST de Obsidian

Hay dos formas de configurar el entorno con la clave API REST de Obsidian.

Agregar a la configuración del servidor (preferible)

{
  "mcp-obsidian": {
    "command": "uvx",
    "args": [
      "mcp-obsidian"
    ],
    "env": {
      "OBSIDIAN_API_KEY": "<your_api_key_here>",
      "OBSIDIAN_HOST": "<your_obsidian_host>"
    }
  }
}

Cree un archivo .env en el directorio de trabajo con la siguiente variable requerida:

OBSIDIAN_API_KEY=your_api_key_here
OBSIDIAN_HOST=your_obsidian_host

Nota: Puede encontrar la clave en la configuración del complemento Obsidian.

Inicio rápido

Instalar

API REST de Obsidian

Necesita el complemento comunitario Obsidian REST API en ejecución: https://github.com/coddingtonbear/obsidian-local-rest-api

Instálelo y habilítelo en la configuración y copie la clave API.

Escritorio de Claude

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-obsidian",
        "run",
        "mcp-obsidian"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY" : "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}

Desarrollo

Edificio

Para preparar el paquete para su distribución:

Sincronizar dependencias y actualizar archivo de bloqueo:

uv sync

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-obsidian run mcp-obsidian

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

También puedes ver los registros del servidor con este comando:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-obsidian.log

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Servidor MCP para interactuar con Obsidian a través del complemento de la comunidad API REST local.

Related MCP Servers

Toolhouse MCP Server
toolhouse-community
-
security
A
license
-
quality
This MCP server allows you to connect MCP clients with Toolhouse's tools.
Last updated -
8
Python
MIT License
MCP Tools for Obsidian
jacksteamdev
-
security
A
license
-
quality
A local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.
Last updated -
60
TypeScript
MIT License
MCP Server Discord Webhook
genm
A
security
A
license
A
quality
An MCP server that enables posting messages to Discord webhooks, allowing customization of content, username, and avatar URL.
Last updated -
1
0
JavaScript
MIT License
generic-mcp-server
v4lheru
-
security
A
license
-
quality
A framework to use with AI to easily create a server for any service. Just drop the API Documentation in it and ask to create the MCP.
Last updated -
4
TypeScript
MIT License

View all related MCP servers

MCP server for Obsidian