local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags within Obsidian.

Servidor MCP de Obsidian

Un servidor MCP (Protocolo de contexto de modelo) que permite a los asistentes de IA interactuar con las bóvedas de Obsidian, proporcionando herramientas para leer, crear, editar y administrar notas y etiquetas.

¡¡¡Advertencia!!!

Este MCP tiene acceso de lectura y escritura (si lo permite). Por favor, haga una copia de seguridad de su bóveda de Obsidian antes de usar obsidian-mcp para administrar sus notas. Recomiendo usar Git, pero cualquier método de copia de seguridad funcionará. Estas herramientas se han probado, pero no a fondo, y este MCP está en desarrollo.

Características

Leer y buscar notas en su bóveda
Crear nuevas notas y directorios
Editar notas existentes
Mover y eliminar notas
Administrar etiquetas (agregar, eliminar, renombrar)
Buscar el contenido de la bóveda

Requisitos

Node.js 20 o superior (podría funcionar en versiones anteriores, pero no lo he probado)
Una bóveda de obsidiana

Instalar

Instalación manual

Añade a tu configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas: %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

Reemplace /path/to/your/vault con la ruta absoluta a su bóveda de Obsidian. Por ejemplo:

MacOS/Linux:

"/Users/username/Documents/MyVault"

Ventanas:

"C:\\Users\\username\\Documents\\MyVault"

Reinicie Claude for Desktop después de guardar la configuración. Debería aparecer el icono del martillo, lo que indica que el servidor está conectado.

Si tiene problemas de conexión, consulte los registros en:

MacOS: ~/Library/Logs/Claude/mcp*.log
Ventanas: %APPDATA%\Claude\logs\mcp*.log

Instalación mediante herrería

Advertencia: No estoy afiliado a Smithery. No lo he probado y recomiendo a los usuarios que lo instalen manualmente si pueden.

Para instalar Obsidian para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install obsidian-mcp --client claude

Desarrollo

# Clone the repository
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp

# Install dependencies
npm install

# Build
npm run build

Luego agrega a tu configuración de Claude Desktop:

{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

Herramientas disponibles

read-note - Leer el contenido de una nota
create-note - Crea una nueva nota
edit-note - Editar una nota existente
delete-note - Eliminar una nota
move-note - Mover una nota a una ubicación diferente
create-directory - Crea un nuevo directorio
search-vault - Buscar notas en la bóveda
add-tags - Agregar etiquetas a una nota
remove-tags - Eliminar etiquetas de una nota
rename-tag - Cambiar el nombre de una etiqueta en todas las notas
manage-tags - Listar y organizar etiquetas
list-available-vaults : enumera todas las bóvedas disponibles (ayuda con configuraciones de múltiples bóvedas)

Documentación

Se puede encontrar documentación adicional en el directorio docs :

creating-tools.md - Guía para crear nuevas herramientas
tool-examples.md - Ejemplos de uso de las herramientas disponibles

Seguridad

Este servidor requiere acceso al directorio de su bóveda de Obsidian. Al configurar el servidor, asegúrese de lo siguiente:

Proporcione acceso únicamente al directorio de bóveda previsto
Revisar las acciones de la herramienta antes de aprobarlas

Solución de problemas

Problemas comunes:

El servidor no aparece en Claude Desktop
- Verifique la sintaxis de su archivo de configuración
- Asegúrese de que la ruta de la bóveda sea absoluta y exista
- Reiniciar Claude Desktop
Errores de permisos
- Asegúrese de que la ruta de la bóveda sea legible y escribible
- Comprueba los permisos de archivos en tu bóveda
Fallos en la ejecución de herramientas
- Consulte los registros de Claude Desktop en:
  - macOS: ~/Library/Logs/Claude/mcp*.log
  - Ventanas: %APPDATA%\Claude\logs\mcp*.log

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Permite que los asistentes de IA interactúen con las bóvedas de Obsidian, proporcionando herramientas para leer, crear, editar y administrar notas y etiquetas.