obsidian-gate
Obsidian Gate
Un servidor MCP que abre tu bóveda de Obsidian a cualquier agente de IA.
npx obsidian-gate init # point at your vault
npx obsidian-gate # dashboard on :3100
Tu bóveda de Obsidian es tu segundo cerebro. Tus agentes de IA deberían poder usarla.
Claude Code, Codex, Cursor: una línea de configuración y tu bóveda se convierte en un espacio de trabajo accesible para agentes. Cada nota, cada enlace, cada etiqueta. Todo local, todo tuyo, sin nube.
Pruébalo
# One command to set up
npx obsidian-gate init
# Start the dashboard
npx obsidian-gate
# → http://localhost:3100/dashboardEso es todo. Tus agentes ahora pueden leer, buscar y escribir en tu bóveda.
Related MCP server: obsidian-autom8
Inicio rápido
1. Apunta a tu bóveda
npx obsidian-gate initSe te pedirá la ruta de tu bóveda. Pégala y obtendrás una clave API.
2. Conecta tu agente
Claude Code — colócalo en tu configuración de MCP:
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["obsidian-gate", "--mcp"]
}
}
}Cualquier cliente MCP sobre HTTP:
{
"mcpServers": {
"obsidian": {
"type": "http",
"url": "http://localhost:3100/mcp",
"headers": { "Authorization": "Bearer sk-your-key" }
}
}
}3. Pregunta a tu agente
Prueba estos:
Prompt | Qué sucede |
"¿En qué trabajé ayer?" | El agente lee tu nota diaria |
"Busca en mi bóveda notas sobre Kubernetes" | Búsqueda de texto completo en todas las notas |
"Guarda esta sesión de depuración en mi bóveda" | Crea una nueva nota con frontmatter |
"Enlaza mis notas de reunión con las notas del proyecto" | Añade un |
Herramientas — 9 operaciones
Herramienta | Qué hace |
| Lista notas y carpetas en una carpeta de la bóveda |
| Contenido completo de la nota + frontmatter analizado |
| Búsqueda de texto completo con resultados clasificados y fragmentos |
| Nueva nota con frontmatter de plantilla de la bóveda |
| Sobrescribe o añade a una nota |
| Cada nota que enlaza aquí mediante |
| Todas las etiquetas — frontmatter e inline — con recuentos |
| Obtiene o crea la nota diaria (hoy, ayer, -1, ISO) |
| Añade un |
Las notas también se exponen como recursos MCP: obsidian://{vault}/{path}.
CLI
Comando | Qué hace |
| Asistente de configuración interactivo |
| Panel + MCP HTTP en :3100 |
| Ejecutar como servidor MCP sobre stdio |
| Verificar acceso a la bóveda y las 9 herramientas |
| Mostrar conexiones de agentes |
| Crear una nueva clave API |
| Rotar una clave |
| Revocar una clave |
| Bóvedas configuradas |
| Añadir una bóveda |
| Eliminar una bóveda |
| Tu plan y uso |
| Activar una clave de licencia |
| Registro de actividad de agentes |
Precios
Nivel | Precio | Qué obtienes |
Gratis | $0 | 50 consultas/mes, 1 bóveda, 1 agente |
Personal | $19/mes | Consultas ilimitadas, 3 bóvedas, agentes ilimitados |
Equipo | $49/mes | Todo lo de Personal + configuración compartida, soporte prioritario |
Prueba gratuita de 14 días en los planes de pago. Sin riesgo. Cancela cuando quieras.
Arquitectura
┌────────────┐ ┌──────────────────────┐ ┌──────────────┐
│ AI Agent │────▶│ obsidian-gate │────▶│ Obsidian │
│ (Claude, │◀────│ (MCP Server) │◀────│ Vault │
│ Codex, │ │ │ │ (files) │
│ Cursor) │ │ stdio ─ dashboard │ └──────────────┘
└────────────┘ └──────────────────────┘Todo local. Cada byte vive en tu máquina. Sin nube, sin servidores, sin sincronización.
Configuración en
~/.obsidian-gate/config.json(modo 0600)Claves API son secretos locales. Tú eres dueño de la pila.
Registro de actividad rastrea cada acción del agente en JSONL.
Qué no es Gate
❌ No es un plugin de Obsidian (pero se planea un plugin de la comunidad)
❌ No es un motor de sincronización (lee/escribe directamente en el directorio de tu bóveda)
❌ No es un editor de notas (Obsidian es mejor en eso)
❌ No es un servicio en la nube (se ejecuta completamente en tu máquina)
Es una pequeña cosa bien hecha: un servidor MCP para tu bóveda.
Hoja de ruta
Servidor MCP con 9 herramientas
Panel local + registro de actividad
Autenticación con clave API + permisos
Licencias Stripe (niveles gratuitos y de pago)
Plugin de la comunidad de Obsidian (instalación con un clic)
Escritura de agentes con frontmatter LLM
Etiquetado automático desde el contenido de la bóveda
Resumen diario: qué cambió en tu bóveda
Desarrollo
git clone https://github.com/rileygramlich/obsidian-gate.git
cd obsidian-gate
npm install
npm run build # compile TypeScript → dist/
npm run dev # hot-reload with tsxCreado por Riley G. — inspirado en el manual de Marc Lou: lanza rápido, nivel gratuito, cero gasto en publicidad, construye en público.
MIT — constrúyelo, publícalo, véndelo.
This server cannot be deployed
Maintenance
Related MCP Connectors
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, read, and append content to notes in an Obsidian vault via the MCP protocol.10,085 npmBSD Zero Clause
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to remotely access and interact with Obsidian vaults via MCP, supporting note operations, tag management, graph queries, and command execution.4GPL 3.0
- FlicenseNot gradedqualityCmaintenanceEnables reading, writing, searching, and managing Obsidian vault notes through MCP tools and prompts, allowing AI agents to interact with local knowledge bases.-
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to search, read, and write notes in an Obsidian vault via MCP tools, and monitor product handoffs and state.MIT