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

Por qué usarlo

Características clave

Ocho herramientas que cubren notas, etiquetas, texto frontal y búsqueda
Modos de actualización de agregar/anteponer/sobrescribir: los agentes no tienen que regenerar archivos completos
Operaciones atómicas a nivel clave
Búsqueda difusa global en toda la bóveda
Capa de almacenamiento en caché para lecturas repetidas más rápidas

Demo en vivo

Cómo se ve en la práctica

obsidian-mcp-server.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-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

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

Casos de uso

Usos del mundo real: Obsidian MCP Server

Capture ideas en la nota diaria de hoy desde cualquier cliente MCP

👤 Usuarios de obsidiana que viven en el chat. ⏱ ~5 min beginner

Cuándo usarlo: Estás en mitad de una conversación con Claude y quieres guardar un pensamiento en tu bóveda sin cambiar de aplicación.

Requisitos previos

Obsidian con el complemento API REST local habilitado — Complementos de la comunidad → instalar 'API REST local' → copiar la clave API
Cliente MCP configurado con OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL — Ver bloque de configuración; La URL base suele ser http://127.0.0.1:27123

Flujo

Compruebe que existe la nota diaria.

Enumere las notas en Daily/2026-04-17.md.✓ Copiado

→ Ruta del archivo confirmada o "no encontrada"
Adjuntar la captura

Agregue '- Idea: pruebe X para el error de almacenamiento en caché' en Daily/2026-04-17.md.✓ Copiado

→ Agregar confirmado sin sobrescribir entradas anteriores

Resultado: Un diario en ejecución al que los agentes pueden agregar, nunca golpear.

Errores comunes

Usar el modo de sobrescritura cuando querías decir agregar — De manera predeterminada, siempre se agrega o antepone las notas diarias; guardar y sobrescribir para borradores nuevos

Combinar con: filesystem

Convierta una semana de notas en un documento de revisión

👤 Trabajadoras del conocimiento haciendo revisiones semanales ⏱ ~20 min intermediate

Cuándo usarlo: Necesita una síntesis del viernes de las notas dispersas de la semana.

Requisitos previos

Notas etiquetadas o fechadas — Utilice una carpeta #semanal o Diaria/

Flujo

Busca las notas de la semana

Búsqueda global: notas modificadas esta semana en Diario/.✓ Copiado

→ Lista de 5 a 7 rutas de archivos
leer cada uno

Lea cada nota diaria y resuma por tema.✓ Copiado

→ Viñetas temáticas, no concatenación cruda
Escribe la reseña

Escriba el resumen en Reviews/2026-W16.md; agregar estado del frontmatter: revisión, etiquetas: [semanal].✓ Copiado

→ Nuevo archivo con portada adecuada

Resultado: Una nota de revisión semanal construida a partir de la materia prima sin copiar y pegar manualmente.

Combinar con: github

Consolide etiquetas desordenadas en una bóveda

👤 Bóvedas que crecieron orgánicamente y ahora tienen variantes #Trabajo / #trabajo / #TRABAJO ⏱ ~30 min intermediate

Cuándo usarlo: La lista de etiquetas es demasiado larga debido a que hay duplicados y casi duplicados.

Flujo

Listar etiquetas actuales

Utilice obsidian_manage_tags para enumerar todas las etiquetas ordenadas por uso.✓ Copiado

→ El recuento de etiquetas muestra los duplicados
Proponer un mapeo

Proponer un conjunto canónico y un mapeo de antiguo → nuevo.✓ Copiado

→ Mesa pequeña y revisable
Aplicar por lotes

Después de confirmar, cambie el nombre de las etiquetas en la bóveda utilizando el mapeo.✓ Copiado

→ Operaciones de etiquetas resumidas por nota

Resultado: Taxonomía de etiquetas limpia por la que realmente puedes navegar.

Errores comunes

Reescribir cientos de notas de una sola vez sin respaldo — Confirme la bóveda en git primero; revisar la diferencia

Combinar con: git

Coloque recortes web en una bandeja de entrada de investigación y etiquételos automáticamente

👤 Investigadoras, analistas, cualquier persona con un hábito de podadoras. ⏱ ~15 min beginner

Cuándo usarlo: La bandeja de entrada/carpeta se acumula más rápido de lo que puedes procesar.

Requisitos previos

Una bandeja de entrada/carpeta designada — Créelo en la bóveda

Flujo

Listar bandeja de entrada

Enumere las notas sin etiquetar en Bandeja de entrada/.✓ Copiado

→ Rutas de elementos pendientes
Clasificar y etiquetar

Para cada uno, sugiera de 1 a 3 etiquetas según el contenido y luego solicítelas con obsidian_manage_tags.✓ Copiado

→ Etiquetas agregadas atómicamente a través de frontmatter

Resultado: La bandeja de entrada sigue siendo pequeña; Los nuevos clips se organizan automáticamente.

Combinar con: fetch

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

obsidian-mcp-server + fetch

Recorte una URL con Fetch y luego escríbala en la Bandeja de entrada/

Obtenga https://... y guarde un resumen limpio en Inbox/YYYY-MM-DD-title.md con el texto inicial adecuado.✓ Copiado

obsidian-mcp-server + github

Copie los resúmenes de relaciones públicas combinados en Proyectos/<repo>.md

Busque relaciones públicas fusionadas esta semana y agregue un resumen en ## Semana 16 en Proyectos/acme-api.md.✓ Copiado

obsidian-mcp-server + git

Versione su bóveda y confirme cambios por lotes

Después de la limpieza de etiquetas, ejecute git diff en la bóveda y resuma antes de confirmar.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
obsidian_read_note	path: str	Leer una nota específica antes de editarla o resumirla
obsidian_update_note	path: str, content: str, mode: 'append'\|'prepend'\|'overwrite'	Agregar o reemplazar el contenido de la nota: por defecto se agrega a menos que se vuelva a escribir
obsidian_search_replace	path: str, find: str, replace: str	Ediciones específicas en notas sin regenerar todo el archivo
obsidian_global_search	query: str, filters?	Encuentra notas en toda la bóveda
obsidian_list_notes	folder?: str	Enumerar notas en una carpeta antes de operaciones por lotes
obsidian_manage_frontmatter	path: str, op: 'get'\|'set'\|'delete', key?: str, value?: any	Cambios atómicos a nivel clave
obsidian_manage_tags	path?: str, op: 'list'\|'add'\|'remove'	Operaciones de higiene y taxonomía de etiquetas.
obsidian_delete_note	path: str	Eliminar una nota: permanente, no se puede deshacer

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Sin API externa: la API REST local se ejecuta en su Mac/PC
Tokens por llamada: Tamaño de una nota; típico 200–3000
Monetario: Gratis
Consejo: Prefiera global_search + lectura bajo demanda en lugar de enumerar de forma masiva carpetas enteras en contexto.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: OBSIDIAN_API_KEY solo en env var, nunca confirmado. Trátelo como un token de administrador local para su bóveda.

Salida de datos: Todo el tráfico es localhost → API REST local de Obsidian. No hay llamadas a la nube desde este servidor.

El complemento API REST local expone su bóveda en un puerto HTTP local; vincúlese solo a 127.0.0.1 y mantenga HTTPS desactivado solo para localhost.
Un atacante que alcanza su OBSIDIAN_API_KEY obtiene lectura/escritura completa en la bóveda; gírelo si sospecha que hay una fuga.

Resolución de problemas

Errores comunes y soluciones

ECONNREGUSADO 127.0.0.1:27123

Obsidian no se está ejecutando o el complemento API REST local está deshabilitado. Abra Obsidian y habilite el complemento.

Verificar: curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/

401 No autorizado

OBSIDIAN_API_KEY no coincide con la clave actual del complemento. Copie el valor de la configuración del complemento nuevamente.

Verificar: Plugin Settings → Local REST API → copy the API key

404 en un archivo conocido

La ruta es relativa a la bóveda y distingue entre mayúsculas y minúsculas; confirme con obsidian_list_notes.

Verificar: obsidian_list_notes folder='Daily'

Alternativas

Obsidian MCP Server vs otros

Alternativa	Cuándo usarla	Contrapartida
obsidian-plugin-skill	Quieres que Claude ayude a crear complementos de Obsidian, no a editar el contenido de la bóveda	Alcance diferente
filesystem MCP	Estás bien con las operaciones de archivos sin formato y no necesitas API de etiquetas/frontmatter compatibles con Obsidian	Pierdes operaciones de etiqueta atómica/frontalidad

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills