Obsidian MCP Tools — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Plugin local de Obsidian + bridge MCP
Búsqueda semántica mediante integración con Smart Connections
Ejecución de prompts de Templater desde Claude
CRUD completo de archivos: leer, escribir, añadir, enlazar, frontmatter
Compatible con notas diarias y diarios
Los datos del vault nunca salen de tu máquina

Demo en vivo

Cómo se ve en la práctica

obsidian-mcp-tools.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Obsidian MCP Tools

Cómo consultar tu segundo cerebro de verdad en lugar de hacer grep

👤 Usuarios de Obsidian PKM con más de 1000 notas ⏱ ~20 min intermediate

Cuándo usarlo: Sabes que escribiste algo hace meses pero la búsqueda por palabras clave sigue fallando.

Requisitos previos

Obsidian + este plugin + plugin Smart Connections — Instala ambos desde Plugins de la Comunidad; Smart Connections indexará en la primera ejecución

Flujo

Verificar indexación

Verifica que Smart Connections haya terminado de generar embeddings de mi vault. Informa del total de notas indexadas.✓ Copiado

→ Número de notas indexadas; modelo de embedding en uso
Recuperación semántica

Encuentra notas relacionadas con 'por qué dejé mi último trabajo' aunque esas palabras exactas no estén en ninguna nota.✓ Copiado

→ 5 notas ordenadas por relevancia semántica, con fragmentos
Componer

Sintetiza esas en una breve nota de reflexión. Guárdala en /Reflections/ con un wikilink a cada fuente.✓ Copiado

→ Nueva nota creada; los backlinks se resuelven

Resultado: Un segundo cerebro que responde en conceptos, no en palabras clave.

Errores comunes

La recuperación semántica muestra notas personales sensibles — Usa la configuración excludedFolders en Smart Connections para omitir directorios privados

Combinar con: humanizer-skill

Ejecutar un template de Templater desde Claude con prompts autocompletados

👤 Usuarios avanzados de Obsidian con templates ⏱ ~10 min intermediate

Cuándo usarlo: Tienes un template de 'inicio de proyecto' en Templater que hace 5 preguntas; prefieres que Claude lo orqueste.

Requisitos previos

Templater instalado con templates configurados — Plugin estándar de la comunidad

Flujo

Listar templates

¿Qué templates de Templater están disponibles?✓ Copiado

→ Lista de templates con descripciones de prompts
Ejecutar con autocompletado

Ejecuta 'project_kickoff' para un proyecto llamado 'Revisión del onboarding Q3'. Responde automáticamente a los prompts basándote en el contexto.✓ Copiado

→ Nueva nota creada usando el template; prompts completados

Resultado: Los templates se ejecutan desde un chat en lugar de un modal.

Errores comunes

Algunos comandos de Templater son async y necesitan tiempo — La herramienta MCP espera a que completen — pero no encadenes demasiados en una sola llamada

Generar automáticamente una nota diaria desde el calendario de ayer + tareas

👤 Usuarios de Obsidian enfocados en productividad ⏱ ~15 min intermediate

Cuándo usarlo: Empiezas cada día editando el mismo template 'Daily' — automatízalo.

Flujo

Recopilar datos del día

Lee la nota diaria de ayer. Lleva las tareas incompletas. Obtén los eventos de hoy mediante el MCP de google-calendar.✓ Copiado

→ Tareas pendientes + eventos de hoy identificados
Escribir la nota diaria

Crea la nota diaria de hoy en /Daily/$(date +%F).md con las secciones estándar.✓ Copiado

→ Nota creada y abierta

Resultado: Nota diaria lista en 5 segundos.

Errores comunes

Llevar tareas duplica las que aparecen en 2 días — Deduplica por texto de línea antes de escribir

Combinar con: google-calendar

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

obsidian-mcp-tools + google-calendar

Construir notas diarias que incluyan los eventos del día

obsidian-mcp-tools + github

Reflejar un tablero de proyecto en una nota del vault

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
search_semantic	query, k?	Recuperación a nivel de concepto	1 consulta a Smart Connections
read_note	path	Obtener una nota individual	gratis
write_note	path, content, mode: 'create'\|'append'\|'overwrite'	Crear o actualizar una nota	gratis
list_templates	(ninguno)	Descubrir qué es ejecutable	gratis
run_templater	template_name, prompt_answers: {}	Ejecutar un flujo de trabajo con template	gratis

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Local — limitado por el servicio de embeddings de Smart Connections si es basado en la nube
Tokens por llamada: 100–1500 por nota
Monetario: Gratis (el plugin); Smart Connections tiene opciones local gratuito + nube de pago
Consejo: Usa la opción de embedding local en Smart Connections para evitar coste por consulta

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Solo plugin local; sin almacenamiento remoto

Salida de datos: Local — excepto si Smart Connections está configurado para usar embeddings en la nube

No des a Claude acceso de escritura al vault a menos que confíes en tu prompt; usa carpetas de exclusión para áreas sensibles

Resolución de problemas

Errores comunes y soluciones

Las herramientas MCP no aparecen

Confirma que el plugin de Obsidian está habilitado y el proceso del bridge MCP está en ejecución

Verificar: Revisa la barra de estado del plugin; reinicia Obsidian

search_semantic no devuelve resultados

Es posible que el job de embeddings de Smart Connections no haya terminado — revisa su progreso

Verificar: Abre el panel lateral de Smart Connections

write_note falla con 'path outside vault'

Las rutas son relativas a la raíz del vault; no uses rutas absolutas

Alternativas

Obsidian MCP Tools vs otros

Alternativa	Cuándo usarla	Contrapartida
ergut/mcp-logseq	Estás en Logseq en lugar de Obsidian	Ecosistema diferente; misma idea
AgriciDaniel/claude-obsidian (skill)	Quieres un flujo de trabajo de nivel skill sobre la E/S de archivos	El skill es de más alto nivel; este MCP son los bloques de construcción

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills