Obsidian MCP

Un servidor MCP (Model Context Protocol) que da a los asistentes de IA (Claude, Cursor, etc.) acceso a tu bóveda de Obsidian. Navega por carpetas, lee notas, créalas, edítalas, muévelas, renómbralas y elimínalas, todo desde tu chat de IA.

Requisitos

• Python 3.10+

• uv (recomendado) o pip

• Una bóveda de Obsidian en tu máquina local

Related MCP server: mcp-obsidian

Instalación

# Clone the repo
git clone https://github.com/your-username/obsidian-mcp
cd obsidian-mcp

# Copy the env template and set your vault path
cp .env.example .env

Edita .env y establece la ruta de tu bóveda:

OBSIDIAN_VAULT_PATH="/Users/you/Documents/MyVault"

Para encontrar la ruta de tu bóveda en Obsidian: Configuración → Acerca de → Ruta de la bóveda.

Ejecutar el servidor

Desarrollo (con la interfaz de MCP Inspector)

uv run mcp dev server.py

Esto abre el MCP Inspector en tu navegador, donde puedes probar todas las herramientas de forma interactiva.

Producción

uv run server.py

Conexión con Cursor

Añade esto a tu .cursor/mcp.json (o a la configuración global de MCP de Cursor):

{
  "mcpServers": {
    "obsidian": {
      "command": "python",
      "args": ["/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Reemplaza /absolute/path/to/obsidian-mcp/server.py con la ruta real a server.py en tu máquina, y /path/to/your/vault con la ruta de tu bóveda (encuéntrala en Obsidian: Configuración → Acerca de → Ruta de la bóveda).

Conexión con Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["run", "/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Herramientas disponibles

Todas las rutas son relativas a la raíz de la bóveda, p. ej. "Projects/App/roadmap.md".

Licencia

MIT