@kazuph/mcp-obsidian

local-only server

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

Integrations

  • Allows access to Obsidian vault content for searching, reading, listing directory structure, and creating notes

Obsidiana MCP

Servidor de Protocolo de Contexto de Modelo para la integración de la bóveda de Obsidian. Esto permite que Claude Desktop (o cualquier cliente MCP) busque y lea sus notas de Obsidian.

Inicio rápido (para usuarios)

Prerrequisitos

  • Node.js 18+ (instalación mediante brew install node )
  • Bóveda de obsidiana
  • Claude Desktop (instalación desde https://claude.ai/desktop )

Configuración

  1. Abra el archivo de configuración de Claude Desktop en: ~/Library/Application Support/Claude/claude_desktop_config.json

Puedes encontrarlo a través del menú de Claude Desktop:

  1. Abra Claude Desktop
  2. Haga clic en Claude en la barra de menú de Mac
  3. Haga clic en "Configuración"
  4. Haga clic en "Desarrollador"
  5. Añade lo siguiente a tu configuración:
{ "tools": { "obsidian": { "command": "npx", "args": ["-y", "@kazuph/mcp-obsidian"], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault" } } } }

Nota: Reemplace /path/to/your/obsidian/vault con su ruta de bóveda de Obsidian real.

Para desarrolladores

Prerrequisitos

  • Node.js 18+ (instalación mediante brew install node )
  • Bóveda de obsidiana
  • Claude Desktop (instalación desde https://claude.ai/desktop )
  • tsx (instalación mediante npm install -g tsx )

Instalación

git clone https://github.com/kazuph/mcp-obsidian.git cd mcp-obsidian npm install npm run build

Configuración

  1. Asegúrese de que Claude Desktop esté instalado y funcionando.
  2. Instale tsx globalmente si aún no lo ha hecho:
npm install -g tsx # or pnpm add -g tsx
  1. Modifique la configuración de Claude Desktop ubicada en: ~/Library/Application Support/Claude/claude_desktop_config.json

Puedes encontrarlo fácilmente a través del menú de Claude Desktop:

  1. Abra Claude Desktop
  2. Haga clic en Claude en la barra de menú de Mac
  3. Haga clic en "Configuración"
  4. Haga clic en "Desarrollador"

Agregue lo siguiente a la configuración de su cliente MCP:

{ "tools": { "obsidian": { "args": ["tsx", "/path/to/mcp-obsidian/index.ts"], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault" } } } }

Herramientas disponibles

  • obsidian_read_notes : Lee el contenido de varias notas. El contenido de cada nota se devuelve con su ruta como referencia.
  • obsidian_search_notes : busca notas por nombre (sin distinguir entre mayúsculas y minúsculas, admite coincidencias parciales y expresiones regulares).
  • obsidian_read_notes_dir : enumera la estructura del directorio bajo una ruta especificada.
  • obsidian_write_note : crea una nueva nota en la ruta especificada.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Conector de bóveda de Obsidian para Claude Desktop: permite leer y escribir notas de Markdown mediante el Protocolo de contexto de modelo (MCP)

  1. Quick Start (For Users)
    1. Prerequisites
    2. Configuration
  2. For Developers
    1. Prerequisites
  3. Installation
    1. Configuration
      1. Available Tools
        ID: sed8z2tqq9