obsidian-sync-mcp
Servidor MCP para Obsidian que permite acceder a la carpeta de archivos del vault desde cualquier agente de IA, incluso cuando el equipo está desconectado. Se ejecuta localmente o en la nube mediante Docker, con soporte para modo filesystem y CouchDB.
Ficha actualizada 23 sept 2026, 12:37 · upstream 23 sept 2026, 12:11 · release v0.7.0
Qué es obsidian-sync-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Obsidian Sync MCP es un servidor compatible con Model Context Protocol que proporciona acceso a la carpeta de archivos del vault de Obsidian desde cualquier agente de IA, incluso cuando el equipo está desconectado. El proyecto se basa en Self-hosted LiveSync, una herramienta de sincronización local para Obsidian. El servidor expone herramientas MCP como read_note, write_note, edit_note, list_folders, list_tags, list_notes, delete_note, move_note y get_note_metadata. Funciona mediante dos modos: filesystem mode (lectura directa de archivos .md) y CouchDB mode (lectura desde una base de datos local o en la nube). El modo CouchDB utiliza livesync-commonlib para manejar chunking y soporte E2E de cifrado. Se puede ejecutar con npx, Docker o Fly.io.
- Acceder a notas del vault desde cualquier dispositivo (teléfono, tablet) sin necesidad de estar en la misma red
- Permitir que agentes de IA como Claude o Copilot accedan al contenido del vault incluso cuando el equipo principal está desconectado
- Sincronizar notas entre dispositivos con diferentes conexiones a internet mediante LiveSync
- Crear un punto de acceso seguro para compartir conocimiento interno sin exponer la carpeta directamente
- Permitir que múltiples agentes de IA accedan al mismo vault desde diferentes máquinas o redes
- Soporta ambos modos: filesystem y CouchDB, con el segundo integrado mediante livesync-commonlib para E2E encryption
- Funciona en modo asíncrono, permitiendo que los agentes accedan al vault incluso cuando la máquina está desconectada
- Proporciona herramientas de lectura y escritura (read_note, write_note, edit_note) con soporte para enlaces de Obsidian
- Soporta OAuth 2.1 con autenticación por contraseña en el navegador del agente
- Permite acceso remoto mediante tunnels como CloudFlare Tunnel o Tailscale
- Ofrece persistencia de datos a través de un directorio .obsidian-mcp para tokens y metadata
- El modo CouchDB requiere LiveSync instalado en Obsidian (plugin con más de 600,000 descargas)
- En modo filesystem, el acceso es local y no puede conectarse desde redes no confiables
- La sincronización entre dispositivos depende del estado de conexión de cada equipo
- El token de autenticación tiene una duración máxima de 14 días sin renovación
- No existe un modo híbrido que combine ambos protocolos simultáneamente
- En modo CouchDB, el archivo .vault debe estar en formato JSON para ser ledo por el servidor
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para Fly.io: clone el repo, ejecutar ./deploy/setup.sh con opción 2 (solo MCP), configurar COUCHDB_PASSPHRASE si se usa cifrado E2E. El endpoint es https://your-app.fly.dev/mcp. Para Docker: usar docker run con -v para persistencia y -e variables de entorno. En modo CouchDB, asegúrate de que LiveSync esté instalado en Obsidian. En modo filesystem, el servidor funciona sin dependencias externas. Siempre se recomienda usar HTTPS mediante un tunnel (CloudFlare Tunnel o Tailscale) para proteger la API contra ataques de reenvío de DNS.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.