Repolode
Enviar
MarkusPfundstein

MarkusPfundstein/mcp-obsidian

Servidor MCP que permite a asistentes de IA leer, buscar, añadir contenido y eliminar notas de un vault de Obsidian mediante el plugin Local REST API.

Ver en GitHub
Estrellas
4,521
Forks
508
Issues abiertos
107
Último commit
hace 2 meses

¿Qué es?

mcp-obsidian es un servidor Model Context Protocol (MCP) que conecta clientes de IA, como Claude Desktop, con un vault de Obsidian. Funciona mediante el plugin comunitario Local REST API para Obsidian, por lo que Obsidian debe estar ejecutándose con el plugin habilitado y una clave API configurada.

Una vez conectado, el asistente puede listar archivos y carpetas de un vault, leer el contenido de una nota, buscar texto en todos los archivos, insertar contenido en relación con un encabezado, una referencia a un bloque o un campo de frontmatter, añadir contenido a un archivo nuevo o existente y eliminar archivos o directorios. La configuración usa una clave API y, de forma opcional, un host y un puerto; los valores predeterminados son 127.0.0.1 y 27124.

El proyecto puede ejecutarse con uvx, desde un entorno uv local o en un contenedor Docker que acceda al host mediante host.docker.internal. Requiere Python 3.11 o posterior y una versión del SDK de Python mcp inferior a 2.0.

Funciones clave

  • 01Lista archivos y directorios en la raíz del vault o en una carpeta específica.
  • 02Lee todo el contenido de una nota.
  • 03Busca texto en todos los archivos del vault.
  • 04Inserta contenido en notas en relación con encabezados, referencias a bloques o campos de frontmatter.
  • 05Añade contenido a archivos nuevos o existentes y elimina archivos o directorios.

Casos de uso

  • Pedir a un asistente de IA que resuma o explique notas almacenadas en Obsidian.
  • Buscar en un vault todas las menciones de un tema y revisar el contexto que las rodea.
  • Generar automáticamente una nueva nota con el resumen de una reunión a partir de notas existentes.
  • Permitir que un asistente de IA mantenga y actualice notas en una base de conocimiento personal.

Inicio rápido

  1. 1

    Instala y activa el plugin comunitario Obsidian Local REST API y copia su clave de API

  2. 2

    Añade el servidor a la configuración de tu cliente MCP con OBSIDIAN_API_KEY, OBSIDIAN_HOST y OBSIDIAN_PORT definidos

  3. 3

    Ejecuta el servidor publicado con uvx

    uvx mcp-obsidian

Antes de usarlo

  • Es necesario tener instalado el plugin comunitario Obsidian Local REST API y ejecutarlo en Obsidian.
  • Se requiere Python 3.11 o posterior, y la dependencia mcp debe mantenerse por debajo de la versión 2.0.

En colecciones

Frameworks y apps de agentes de IA open sourceServidores MCP

Temas

#mcp#obsidian#notes#knowledge-management#llm#python#ai-agent

Preguntas frecuentes

¿Qué es mcp-obsidian?
Servidor MCP que permite a asistentes de IA leer, buscar, añadir contenido y eliminar notas de un vault de Obsidian mediante el plugin Local REST API. mcp-obsidian es un servidor Model Context Protocol (MCP) que conecta clientes de IA, como Claude Desktop, con un vault de Obsidian. Funciona mediante el plugin comunitario Local REST API para Obsidian, por lo que Obsidian debe estar ejecutándose con el plugin habilitado y una clave API configurada.
¿mcp-obsidian es gratuito? ¿Qué licencia tiene?
mcp-obsidian es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-obsidian sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de mcp-obsidian fue el 31 ago 2026.
¿Para qué puedo usar mcp-obsidian?
Pedir a un asistente de IA que resuma o explique notas almacenadas en Obsidian. Buscar en un vault todas las menciones de un tema y revisar el contexto que las rodea. Generar automáticamente una nueva nota con el resumen de una reunión a partir de notas existentes. Permitir que un asistente de IA mantenga y actualice notas en una base de conocimiento personal.
¿Cómo se instala mcp-obsidian?
Instala y activa el plugin comunitario Obsidian Local REST API y copia su clave de API Añade el servidor a la configuración de tu cliente MCP con OBSIDIAN_API_KEY, OBSIDIAN_HOST y OBSIDIAN_PORT definidos Ejecuta el servidor publicado con uvx: uvx mcp-obsidian
¿Dónde consigo mcp-obsidian?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/MarkusPfundstein/mcp-obsidian

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados