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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

mapbox-mcp-server
AidenYangX
A
security
A
license
A
quality
MCP Server for the Mapbox API.
Last updated -
5
3
TypeScript
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 -
229
TypeScript
MIT License
Teamwork MCP
Vizioz
A
security
A
license
A
quality
An MCP server that connects to the Teamwork API, providing a simplified interface for interacting with Teamwork projects and tasks.
Last updated -
35
12
6
TypeScript
MIT License
mc-server-clash-of-clans
Saunved
-
security
F
license
-
quality
MCP server for the Clash of Clans API. Can get player, clan information, analyze ongoing wars, as well as war logs (provided they are public).
Last updated -
3
JavaScript

View all related MCP servers

MCP server for Obsidian