Graph Context for Claude Code

Plugin de Obsidian muy reciente que conecta el vault con el selector /ide de Claude Code: al seleccionar texto se envía automáticamente contexto del grafo (enlaces resueltos, backlinks, ruta de encabezados).

Este plugin muy reciente (junio de 2026) hace visible Obsidian dentro del mecanismo de IDE integrado de Claude Code — el mismo procedimiento de archivo lock más WebSocket local que también usan las extensiones oficiales de VS Code y JetBrains. Al cargarse, el plugin inicia un servidor WebSocket en 127.0.0.1 y escribe un archivo lock con el puerto, la ruta del vault y un token de autenticación de sesión en ~/.config/claude/ide/<port>.lock o ~/.claude/ide/<port>.lock. Claude Code encuentra este archivo automáticamente, se conecta, se autentica con el token y a partir de ahí habla MCP mediante JSON-RPC. El verdadero valor añadido está en la capa «Graph Context»: al seleccionar texto en una nota, el plugin no envía solo el markdown en bruto con [[enlaces]] opacos, sino que los resuelve del lado del servidor con el propio resolver metadataCache de Obsidian y lo envía todo en un único payload — los ![[embeds]] incrustados de forma completa, los [[wikilinks]] como resumen breve (frontmatter + primer párrafo), la ruta de encabezados del cursor, el frontmatter y los backlinks. La diferencia con los servidores MCP clásicos de Obsidian: ahí Claude tiene que resolver cada enlace individualmente mediante una llamada a herramienta (N enlaces = N×2 idas y vueltas); aquí el contexto resuelto llega automáticamente junto con la selección, sin llamadas a herramientas adicionales. La resolución está deliberadamente limitada a un solo nivel de profundidad (los enlaces de un enlace ya enlazado no se siguen expandiendo) y con límites de tamaño (embeds 2000 caracteres, resúmenes de wikilinks 200, 8000 en total, backlinks 20), con indicadores explícitos de truncado en lugar de un corte silencioso. Solo funciona en Obsidian de escritorio, ya que requiere un servidor WebSocket de Node.

🔧 SETUP

Requiere Obsidian de escritorio (el plugin es isDesktopOnly) y una instalación de Claude Code funcionando en la terminal.
Compilar manualmente, ya que aún no hay listado en el catálogo de plugins de la comunidad: clonar el repositorio y luego `npm install && npm run build`.
Copiar `main.js` y `manifest.json` en tu propio vault: `<vault>/.obsidian/plugins/graph-context-for-claude-code/`.
En Obsidian, en Settings → Community plugins, desactivar el Restricted Mode si hace falta y activar «Graph Context for Claude Code» — aparece un mensaje «ready on port <PORT>».
En una terminal aparte, iniciar `claude`, escribir `/ide` y seleccionar «Obsidian»; después seleccionar texto en una nota y preguntarle a Claude directamente.

✅ ¿CUÁNDO USARLO?

Notas con muchos enlaces como contexto para una pregunta

Al seleccionar un párrafo que enlaza a varias otras notas y preguntar «Resume lo que he seleccionado y cómo se relaciona con las notas enlazadas», Claude ya tiene el contenido enlazado en el primer payload, sin cargar cada enlace por separado.

Consultas rápidas sobre una sola nota sin configurar clave de API

Quien solo quiera acceder ocasionalmente a una única nota de Obsidian durante una sesión de programación en Claude Code no necesita el servidor HTTPS aparte con clave de API que exige la solución Local REST API — aquí basta con `/ide` y seleccionar Obsidian.

⛔ ¿CUÁNDO MEJOR NO?

Uso móvil o automatización sin la app de Obsidian abierta

El plugin es explícitamente isDesktopOnly y necesita una instancia de Obsidian de escritorio en ejecución con un servidor WebSocket activo — no existe un modo headless.

Mejor: Para automatización sin la app de Obsidian abierta, usar la Obsidian Local REST API con su servidor HTTPS independiente.

Se necesitan enlaces de varios saltos de profundidad de forma automática

La expansión del grafo está deliberadamente limitada a una profundidad de 1 — los enlaces dentro de una nota enlazada ya expandida no se siguen resolviendo.

Mejor: Para un recorrido de grafo más profundo, usar específicamente las herramientas MCP de Local REST API o una herramienta de grafo dedicada como Graphify con exportación a Obsidian.