Obsidian Vault MCP (gratuito, sin tarjeta, sin necesidad de ordenador siempre encendido)

Esto le da a Claude (móvil, escritorio, web) acceso de lectura a tu bóveda de Obsidian a través de un pequeño servidor alojado gratuitamente en Render, que lee directamente desde un repositorio de GitHub. Tu bóveda se sincroniza con GitHub desde tu teléfono y escritorio mediante el plugin Obsidian Git — no es necesario que nada permanezca encendido.

Componentes

• Repositorio de GitHub — la fuente de verdad de la bóveda (gratuito, privado).

• Plugin Obsidian Git — auto-commit/push/pull desde escritorio + teléfono.

• Este servidor MCP — lee el repositorio a través de la API de GitHub, expone list_notes, read_note, search_notes sobre MCP. Desplegado gratuitamente en Render.

• Graphify — opcional, ejecútalo localmente, sube su salida al repositorio como cualquier otra nota.

Related MCP server: Obsidian MCP Server

1. Crear el repositorio de GitHub

1. github.com → Nuevo repositorio → nómbralo, p. ej., obsidian-vault → Privado → Crear.

2. Configuración → Configuración de desarrollador → Tokens de acceso personal → Token de grano fino:

   • Acceso al repositorio: solo este repositorio.

   • Permisos: Contenido → Leer y escribir (necesario para que Claude pueda crear y editar notas, no solo leerlas).

   • Copia el token — lo pegarás en Render como GITHUB_TOKEN.

2. Configurar Obsidian Git (escritorio + teléfono)

1. Obsidian → Configuración → Plugins de la comunidad → explorar → instala Obsidian Git.

2. Apunta tu carpeta de bóveda a un clon local del repositorio (o haz git init en su lugar y añade el repositorio de GitHub como origin).

3. En la configuración del plugin, activa copia de seguridad automática en intervalo (p. ej., cada 10 minutos) y auto pull al cargar — hará commit + push + pull por ti.

4. En el teléfono: instala Obsidian móvil, añade el mismo plugin (funciona en iOS/Android), inicia sesión en GitHub en la pantalla de autenticación del plugin.

Ahora cada dispositivo hace push/pull al mismo repositorio — ese repositorio es tu capa de sincronización.

3. Desplegar el servidor MCP en Render (gratuito)

1. Sube esta carpeta (server.js, package.json, render.yaml) a su propio repositorio de GitHub público o privado (separado del repositorio de la bóveda).

2. render.com → Nuevo → Servicio web → conecta ese repositorio.

3. Debería detectar automáticamente render.yaml. Si no: Comando de compilación npm install, Comando de inicio npm start, plan Gratuito.

4. Añade variables de entorno:

   • GITHUB_TOKEN — el token de grano fino del paso 1

   • GITHUB_OWNER — tu nombre de usuario de GitHub

   • GITHUB_REPO — el nombre de tu repositorio de bóveda (p. ej., obsidian-vault)

   • GITHUB_BRANCH — main (o la rama que tengas por defecto)

   • MCP_SHARED_SECRET — inventa una cadena aleatoria; esto evita que cualquiera que encuentre tu URL de Render pueda leer tu bóveda

5. Despliega. Obtendrás una URL como https://obsidian-vault-mcp.onrender.com.

Nota sobre el nivel gratuito: se duerme después de ~15 minutos de inactividad y tarda unos segundos en despertar en la siguiente solicitud — suficiente para consultas ocasionales de Claude.

4. Conectarlo a Claude

En Claude → Configuración → Conectores → Añadir conector personalizado:

• URL: https://<tu-app>.onrender.com/mcp

• Cabecera: Authorization: Bearer <tu MCP_SHARED_SECRET>

Luego solo pídele a Claude que busque, lea o edite tus notas — llamará automáticamente a search_notes / read_note / list_notes / write_note / delete_note. Las escrituras se confirman directamente en el repositorio, por lo que aparecerán en tu teléfono/escritorio la próxima vez que Obsidian Git sincronice (o inmediatamente si tienes activado el auto-pull-en-intervalo).

Atención con las escrituras: write_note sobrescribe todo el archivo — para editar una nota existente, pídele a Claude que la lea primero, luego escribe de vuelta el contenido completo actualizado. delete_note es un commit real y permanente de git; vale la pena pedirle a Claude que confirme contigo antes de eliminar algo.

5. Graphify — automático, gratuito, sin necesidad de alojamiento

Graphify construye un grafo de conocimiento a partir de tus notas. La extracción semántica necesita un LLM, y la opción gratuita que no necesita alojamiento es el nivel gratuito de Gemini API de Google (sin tarjeta de crédito, no caduca).

Obtén una clave gratuita de Gemini:

1. Ve a aistudio.google.com, inicia sesión con una cuenta de Google.

2. Obtén clave de API → Crear clave de API. Cópiala.

Añade el flujo de trabajo de GitHub Actions:

1. En tu repositorio de bóveda, crea .github/workflows/graphify.yml con el contenido de vault-workflow/.github/workflows/graphify.yml de este proyecto.

2. Repositorio → Configuración → Secretos y variables → Actions → Nuevo secreto de repositorio:

   • Nombre: GEMINI_API_KEY

   • Valor: la clave de AI Studio

3. Repositorio → Configuración → Actions → General → Permisos de flujo de trabajo → configúralo en Permisos de lectura y escritura (para que el flujo de trabajo pueda subir el grafo de vuelta).

4. Se ejecuta automáticamente una vez al día, y también cada vez que subes un cambio a la bóveda. También puedes activarlo manualmente desde la pestaña Actions del repositorio.

Esto produce graphify-out/graph.json y graphify-out/GRAPH_REPORT.md en tu repositorio de bóveda — sin servidor, sin Space, nada que mantener en ejecución.

El servidor MCP ya tiene herramientas para ello (graph_overview, graph_find_node, graph_neighbors) — leen el grafo directamente desde GitHub de la misma manera que read_note. Nada extra que desplegar; solo vuelve a desplegar el server.js actualizado en Render y aparecerán la próxima vez que Claude se conecte.

Prueba local (opcional, antes de desplegar)

npm install
GITHUB_TOKEN=xxx GITHUB_OWNER=you GITHUB_REPO=obsidian-vault npm start

Luego haz un POST a http://localhost:3000/mcp con un cliente MCP, o simplemente despliega directamente en Render y prueba a través de Claude.