Lo esencial
Cada sesión con Claude empieza de cero: si no tienes activada la memoria o un archivo con reglas, no recuerda nada de ti. Tú pierdes tiempo explicando y él gasta tokens en entender el contexto. Obsidian resuelve ese problema: armas una base de conocimiento en archivos markdown, Claude la lee directamente y trabaja en contexto desde el primer momento.
Conceptos clave
- Local-first (primero local): los archivos están en tu computadora, no en la nube; tus datos están bajo tu control
- Markdown = el idioma de la IA: Claude lee archivos
.mddirectamente, sin conversión - Grafo de enlaces: las conexiones entre notas con
[[Nombre]]forman una red de conocimiento, parecida a una red neuronal - Patrón Hot Cache: los datos que necesitas seguido van en una carpeta aparte, para que Claude cargue solo eso
- MCP filesystem: el puente entre Claude Code y tu vault (la bóveda, la carpeta de notas de Obsidian)
- Smart Connections: búsqueda semántica en todo el vault, no solo por palabras clave
- Daily Note (nota diaria): la bitácora diaria del desarrollador, con tareas, decisiones y el costo de las sesiones de IA
Teoría
Para qué sirve un "segundo cerebro"
Una situación típica: hace tres semanas investigaste el mercado inmobiliario de Ecuador. Escribiste un reporte y te quedaste con los detalles. Hoy un cliente te hace una pregunta relacionada. Empiezas a explicarle el contexto a Claude y gastas 15 minutos y 2,000 tokens en algo que ya estaba investigado.
Con una base de conocimiento en Obsidian: abres Claude, le pasas la ruta de la nota por MCP y haces la pregunta. Claude ya está en contexto. 30 segundos en lugar de 15 minutos.
Eso se multiplica por el número de proyectos, de clientes y de meses de trabajo. Una base de conocimiento es un activo que gana valor con el tiempo.
Por qué Obsidian y no Notion o Google Docs
Tres razones por las que Obsidian gana para quien desarrolla con IA:
Razón 1: Local-first
Los archivos viven en tu computadora, en una carpeta del disco. No hay suscripción que te puedan cancelar (Obsidian es gratis, también para uso laboral). No hay API que se pueda caer. No hay dudas sobre de quién son los datos. MCP filesystem lee esos archivos directamente: sin exportaciones, sin conversiones, sin OAuth.
Notion guarda los datos en los servidores de Notion. Para que Claude lea una nota de Notion, hace falta una conexión (un conector o un servidor MCP) con autorización. Son pasos de más, y si el servicio no está disponible, te quedas sin datos. Más sobre Notion: Notion AI como base de conocimiento del equipo.
Razón 2: Markdown = el idioma nativo de la IA
Todos los archivos .md son simplemente texto con un formato sencillo. Claude los lee como texto normal. No hay que procesarlos, no se pierde el formato y no hay problemas de codificación.
Cuando un agente escribe el resultado de una investigación directo en una nota de Obsidian, escribe markdown. Cuando Claude lee esa nota por MCP, lee el mismo markdown. Un solo formato en todos lados.
Razón 3: El grafo de conocimiento
En Obsidian las notas se conectan con enlaces: [[Mercado de Cuenca]], [[Cliente — Pérez]], [[Proyecto — Departamentos Centro]]. Obsidian construye un grafo visual de esas conexiones. Ves cómo se relacionan los conceptos entre sí, como en una red neuronal.
Estructura de carpetas para quien desarrolla con IA
Usamos el sistema PARA (Projects, Areas, Resources, Archive: proyectos, áreas, recursos, archivo), una estructura probada que crece bien:
vault/
├── 00-hot-cache/ ← los archivos más necesarios (Claude los carga primero)
├── 01-inbox/ ← ideas en bruto, notas de voz sin procesar, notas rápidas
├── 02-projects/ ← proyectos activos (una carpeta = un proyecto)
│ ├── acme-realty/
│ │ ├── CLIENT-BRIEF.md
│ │ ├── market-research.md
│ │ └── meeting-notes/
│ └── academy-course/
├── 03-areas/ ← áreas permanentes de tu vida y tu negocio
│ ├── finances.md
│ ├── health.md
│ └── ai-stack.md ← qué herramientas usas, qué claves de API (no las claves mismas)
├── 04-resources/ ← referencias, investigaciones, glosarios
│ ├── ecuador-real-estate/
│ ├── ai-tools/
│ └── code-snippets/
├── 05-archive/ ← proyectos terminados, lo que ya no es vigente
└── templates/ ← plantillas de notas
├── daily-note.md
├── project.md
├── meeting.md
└── research.md¿Por qué ese orden de carpetas?
El número al inicio del nombre es la prioridad de orden. 00-hot-cache siempre queda arriba. Es la carpeta que Claude lee primero. Ahí pones lo que necesitas en casi todas las sesiones: el contexto actual de los proyectos, las decisiones clave, las tareas activas.
El patrón Hot Cache: ahorro de tokens
Es uno de los patrones más prácticos para trabajar con Claude.
El problema: con el tiempo, el vault crece. 300 notas, 500, 1000. Si le das a Claude todo el vault, son miles de tokens solo para navegar y leer cosas que no hacen falta. Caro y lento.
La solución: una carpeta 00-hot-cache/ con los archivos que necesitas en el 90% de las sesiones.
Qué guardar ahí:
00-hot-cache/
├── CONTEXT.md ← quién eres, qué proyectos están activos, estado actual
├── active-projects.md ← 3-5 proyectos activos en un solo archivo
├── decisions-log.md ← las últimas 10 decisiones clave
├── ai-costs-this-month.md ← cuánto gastaste en IA, el límite
└── weekly-goals.md ← las metas de la semanaLa instrucción para Claude en el CLAUDE.md del proyecto:
## Mi vault de Obsidian Ruta: ~/vault/ Al iniciar la sesión, primero lee: - ~/vault/00-hot-cache/CONTEXT.md - ~/vault/00-hot-cache/active-projects.md Esos dos archivos te dan el 80% del contexto necesario. Lo demás, pídelo cuando haga falta.
El ahorro: en lugar de cargar todo el vault (miles de tokens), dos archivos (300-500 tokens). Es un 90% de ahorro de tokens en contexto.
Plugins para quien desarrolla con IA
Obsidian admite plugins desde su tienda integrada (Settings → Community Plugins). La lista para nuestro caso:
Smart Connections: búsqueda semántica en el vault (revisa en el catálogo de plugins que tenga mantenimiento y sea compatible con tu versión de Obsidian)
La búsqueda normal busca por palabras clave. Smart Connections entiende el significado. Si preguntas "¿qué sé de la competencia?", encuentra todas las notas relacionadas aunque la palabra "competencia" no aparezca en ellas.
Además, dentro de Obsidian puedes hacer preguntas sobre tus notas con un chat de IA integrado. Smart Connections se integra en Obsidian y responde usando tus archivos como contexto. Es RAG (Retrieval-Augmented Generation: generación con búsqueda en tus documentos) directo en la interfaz, sin configurar nada.
Copilot: Claude o GPT dentro de Obsidian
Un plugin de la comunidad (no confundir con GitHub Copilot) que agrega un panel lateral con un chat de IA. Puedes hacer preguntas usando la nota actual como contexto. Útil cuando trabajas en Obsidian y quieres completar o reescribir una nota con IA sin cambiarte a Claude Code.
QuickAdd: agregar notas rápido con plantillas
Presionas un atajo de teclado, eliges una plantilla (reunión/idea/investigación), llenas dos campos y la nota se crea en la carpeta correcta con la estructura correcta. Sin QuickAdd, cada vez tienes que pensar a mano dónde poner la nota y cómo llamarla.
Dataview: consultas tipo SQL sobre tus notas
Es una base de datos completa encima de tus archivos markdown. Si agregas metadatos a las notas (frontmatter), Dataview puede hacer consultas:
```dataview TABLE cost_usd, agent, status FROM "02-projects/acme-realty" WHERE status = "complete" SORT cost_usd DESC ```
El resultado: una tabla con todas las tareas de IA terminadas del proyecto y su costo. Directo en una nota de Obsidian.
Nota a octubre de 2026: Obsidian trae un plugin integrado (core plugin) llamado Bases, que hace consultas en tabla parecidas sobre las propiedades de las notas desde la interfaz, sin código. Para tablas sencillas, empieza por ahí. Dataview sigue siendo útil para lógica compleja, pero lleva tiempo sin nuevas versiones, así que no construyas nada crítico sobre él.
Templater: plantillas dinámicas
Templater hace plantillas con lógica. Por ejemplo, la plantilla de la nota diaria inserta sola la fecha de hoy, el día de la semana y un enlace a la nota de ayer. No tienes que llenarlo a mano cada vez.
---
date: <% tp.date.now("YYYY-MM-DD") %>
week: <% tp.date.now("WW") %>
---
# <% tp.date.now("dddd, DD MMMM YYYY") %>
## Tareas del día
- [ ]
## Sesiones de IA de hoy
| Tarea | Agente | Costo |
|--------|-------|-----------|
| | | |
## Decisiones y notas
## Ideas para el inbox
[[<% tp.date.now("YYYY-MM-DD", -1) %>]] ← ayerCalendar: navegar por tus notas diarias
Agrega un calendario al panel lateral. Das clic en una fecha y se abre la nota diaria de ese día. Una forma sencilla de encontrar qué hiciste hace una semana.
Claude + Obsidian: patrones prácticos
Patrón 1: Preguntarle a tu base de conocimiento
El patrón más sencillo. Arrancas Claude Code en la carpeta del vault (o la agregas con el comando /add-dir); para un chat sin acceso a archivos conectas el filesystem MCP. Le dices a Claude dónde está el vault y haces tu pregunta:
Lee mis notas en ~/vault/04-resources/ecuador-real-estate/ y responde: ¿qué sé sobre los errores típicos de los compradores en Cuenca?
Claude lee todos los archivos de la carpeta y arma la respuesta a partir de tus propias notas. No es internet ni conocimiento general: son tus propias observaciones, de tu base.
Patrón 2: El agente escribe en el vault
Un agente investigador recibe una tarea → la hace → escribe el resultado directo en el vault:
## Tarea para el agente Investiga los precios actuales de renta en Cuenca. Guarda el resultado en ~/vault/04-resources/ecuador-real-estate/rent-prices-2026-10.md Usa la plantilla de ~/vault/templates/research.md
La próxima vez que necesites ese análisis, ya está en el vault. El agente lo lee y no lo vuelve a hacer.
Patrón 3: Voz → Nota
Un flujo para las ideas que se te ocurren en la calle:
Grabas una nota de voz en el celular →
Whisper (o una app de dictado, como Superwhisper, MacWhisper o Wispr Flow) la transcribe a texto →
El texto cae en ~/vault/01-inbox/ →
Claude procesa el inbox y acomoda las notas en sus carpetasEsto resuelve el problema de "se me ocurrió una gran idea en la regadera y se me olvidó antes de llegar a la computadora".
Patrón 4: Nota automática después de una reunión
## Instrucción para Claude después de una reunión con un cliente
El usuario te pasa la transcripción o sus notas.
Creas en ~/vault/02-projects/{project}/ el archivo meeting-{date}.md
Estructura: participantes, decisiones clave, siguientes pasos, fechas límite.
Lo conectas con enlaces [[]] a las notas que ya existen del proyecto.MCP para trabajar con tu vault de Obsidian
Primero, una aclaración importante: Claude Code ya lee y escribe archivos en la carpeta donde lo arrancaste, y las carpetas adicionales se agregan con el comando /add-dir o con la opción --add-dir. Por eso, para Claude Code, el camino más simple es abrir la terminal en la carpeta del vault y ejecutar claude. El MCP hace falta donde el asistente no tiene acceso directo a los archivos (por ejemplo, en la app de chat) o cuando necesitas funciones que no tienen las operaciones de archivos normales.
Hay dos formas de conectarlo por MCP.
Forma 1: Filesystem MCP (oficial)
Le da a Claude acceso de lectura y escritura a la carpeta del vault por MCP.
# Agregar el filesystem MCP para el vault
claude mcp add filesystem -- \
npx -y @modelcontextprotocol/server-filesystem \
~/vault
# Comprobar que se agregó
claude mcp listUna vez conectado, Claude puede leer y escribir archivos del vault directamente. Cambia ~/vault por la ruta real.
Forma 2: Obsidian MCP (de la comunidad, más completo)
Da funciones extra: búsqueda en el vault, manejo de etiquetas, grafo de enlaces. Hay varios servidores y plugins así (por ejemplo, plugins que levantan un servidor MCP dentro de Obsidian). El comando para conectarlo depende del proyecto que elijas; revisa el formato en su README. Antes de instalarlo, comprueba que el proyecto tenga mantenimiento y no pida permisos sospechosos: el servidor MCP tendrá acceso a tus notas.
Un MCP así entiende la estructura de Obsidian: el frontmatter, los enlaces wiki [[]], las etiquetas #. El filesystem MCP solo ve archivos de texto.
Cuál elegir:
| Filesystem MCP | Obsidian MCP | |
|---|---|---|
| Instalación | Más sencilla | Más complicada |
| Confiabilidad | Oficial | De la comunidad |
| Búsqueda | Por el contenido de los archivos | Depende del servidor que elijas |
| Entiende la estructura | No | Sí (etiquetas, enlaces) |
| Escribe archivos | Sí | Sí |
Empieza por lo más simple: Claude Code en la carpeta del vault y, si hace falta, el filesystem MCP. Es oficial y funciona de inmediato.
Daily Note: la bitácora de quien desarrolla con IA
La nota diaria es una nota que creas cada día. No es un diario de emociones: es una bitácora de operaciones.
Qué anotar:
---
date: 2026-10-09
week: 41
---
# Viernes, 09 de octubre de 2026
## Tareas
- [x] Escribir una lección del curso
- [ ] Conectar el filesystem MCP al vault
- [ ] Revisión de código para el cliente X
## Sesiones de IA
| Tarea | Agente | Modelo | Costo |
|--------|-------|--------|-----------|
| Lección del curso | writer | Sonnet | $0.12 |
| Investigación de mercado | researcher | Sonnet | $0.08 |
**Total de hoy: $0.20**
## Decisiones
- Elegimos filesystem MCP en lugar de Obsidian MCP: es oficial y más sencillo
- Estructura estándar PARA para el vault
## Ideas
- Se puede automatizar la creación de la nota diaria con un hook session-start
## Bloqueos
- Hay que probar Superwhisper en M1 para voz → texto
[[2026-10-08]] ← ayer | mañana → [[2026-10-10]]Los enlaces al día anterior y al siguiente, abajo, sirven para navegar con el plugin Calendar.
Para qué anotar el costo de las sesiones de IA:
En un mes verás las cifras y entenderás cuánto cuesta al mes researcher y cuánto writer (los montos de las tablas de arriba son inventados, como ejemplo). En qué se va de verdad el dinero lo ves en los datos, no en las sensaciones. Eso te permite optimizar tu presupuesto.
Plantilla de nota de PROYECTO
Cada proyecto en 02-projects/ empieza con este archivo:
--- project: Acme Realty status: active client: internal started: 2026-10-01 tags: [real-estate, ecuador, content] --- # Proyecto: Acme Realty ## Qué es Un proyecto de contenido sobre bienes raíces en Ecuador para compradores extranjeros. ## Estado actual Fase 1: desarrollo de la estrategia de contenido. ## Decisiones clave - [[2026-10-07]] Elegimos WhatsApp como canal principal - [[2026-10-08]] Definimos la voz de marca (brand voice): observador, no experto ## Tareas activas - [ ] Escribir 5 publicaciones para el lanzamiento - [ ] Configurar Obsidian MCP para reportes automáticos ## Notas relacionadas - [[Mercado inmobiliario de Cuenca]] - [[Audiencia — compradores extranjeros en Latinoamérica]] - [[Competencia — canales de bienes raíces]] ## Historial de sesiones de IA | Fecha | Tarea | Costo | |------|--------|-----------| | 2026-10-08 | Investigación de mercado | $0.08 | | 2026-10-09 | Plan de contenido | $0.05 |
Dataview puede filtrar por status: active y mostrar todos los proyectos activos en una sola página.
Práctica
Paso 1: Instala Obsidian y crea un vault
# Descarga Obsidian: obsidian.md (gratis, también para uso laboral)
# Instalación con brew (Mac):
brew install --cask obsidianÁbrelo y crea un vault nuevo en un lugar cómodo (por ejemplo, ~/vault o ~/Documents/vault). No en iCloud si no quieres sincronización: los archivos de todos modos estarán en Git.
Paso 2: Crea la estructura de carpetas
# Cambia ~/vault por la ruta real de tu vault
VAULT=~/vault
mkdir -p $VAULT/00-hot-cache
mkdir -p $VAULT/01-inbox
mkdir -p $VAULT/02-projects
mkdir -p $VAULT/03-areas
mkdir -p $VAULT/04-resources
mkdir -p $VAULT/05-archive
mkdir -p $VAULT/templatesPaso 3: Crea tu primer CONTEXT.md en el hot-cache
cat > $VAULT/00-hot-cache/CONTEXT.md << 'EOF'
# Contexto: quién soy y qué estoy haciendo ahora
## Sobre mí
Desarrollo con IA, armo automatizaciones con Claude Code.
Proyectos activos: [enuméralos]
## Proyectos activos
- **Proyecto 1**: [descripción breve, estado actual]
- **Proyecto 2**: [descripción breve, estado actual]
## Mi stack de IA
- Claude Code (elijo el modelo según la tarea)
- Vault de Obsidian para el conocimiento
- Ollama para modelos locales (datos privados)
## Metas actuales (semana)
- [ ] Conectar el filesystem MCP
- [ ] Configurar la plantilla de nota diaria
EOFPaso 4: Conecta el filesystem MCP a Claude Code
# Agregar el MCP (cambia la ruta por la real)
claude mcp add filesystem -- \
npx -y @modelcontextprotocol/server-filesystem \
~/vault
# Comprobar
claude mcp listDespués, en una sesión nueva de Claude Code, escribe:
Lee el archivo ~/vault/00-hot-cache/CONTEXT.md y dime qué aprendiste sobre el contexto actual
Claude debe leer el archivo y responder con base en su contenido.
Paso 5: Instala los plugins
En Obsidian: Settings (Ctrl+, o Cmd+, en Mac) → Community Plugins → Turn on → Browse.
Instálalos en este orden:
- Templater: plantillas con lógica
- Calendar: navegar por las notas diarias
- Dataview: consultas sobre tus notas
- QuickAdd: agregar notas rápido
- Smart Connections: búsqueda semántica (opcional; la configuración del modelo está en la documentación del plugin)
Para tablas sencillas sobre tus notas, prueba primero el plugin integrado Bases (Settings → Core plugins).
Paso 6: Configura la plantilla de nota diaria
Crea el archivo templates/daily-note.md con la estructura básica de la teoría. En la configuración de Daily Notes (Settings → Core Plugins → Daily Notes), indica la carpeta para las notas diarias y la plantilla.
Con Templater, crea una versión más avanzada con la fecha automática y enlaces a los días vecinos.
Paso 7: Tu primer uso real
Toma cualquier tarea que estés haciendo ahora para un cliente o un proyecto. Crea una nota con la plantilla de proyecto. Conecta Claude por MCP y hazle una pregunta sobre el contenido de la nota.
Comprueba que funciona: Claude lee el archivo y responde usando precisamente tus datos.
Herramientas y recursos
- obsidian.md: descarga Obsidian (gratis, también para uso laboral)
- Obsidian Community Plugins: el catálogo de todos los plugins
- Smart Connections: búsqueda semántica
- Templater: documentación del plugin
- Dataview: documentación completa de las consultas
- @modelcontextprotocol/server-filesystem: el filesystem MCP oficial
- Obsidian MCP: busca servidores y plugins de la comunidad en el catálogo de plugins de Obsidian y en el catálogo de MCP; elige proyectos con mantenimiento
- Superwhisper: voz → texto en Mac (para el patrón voz → inbox); hay herramientas parecidas en el catálogo de la Academia: Herramientas
- PARA Method: la metodología original para estructurar el vault
Ideas clave
En resumen: Obsidian + filesystem MCP = memoria de largo plazo para Claude. Construyes la base de conocimiento una vez y trabaja para ti en todas las sesiones futuras.
El patrón Hot Cache: 2 archivos en
00-hot-cache/cubren el 80% de la necesidad de contexto con un mínimo de tokens.
Local-first gana: archivos markdown en tu disco que Claude Code lee directamente, sin API y sin OAuth.
La nota diaria = una bitácora de operaciones: tareas + sesiones de IA + decisiones. En un mes verás patrones en tu trabajo que de otro modo serían invisibles.
Empieza con lo mínimo: vault + filesystem MCP + un CONTEXT.md. Complícalo cuando sientas que hace falta.
Qué sigue
→ Notion AI como base de conocimiento del equipo: cuando el conocimiento no es solo para ti, sino para el equipo
La marca se guarda solo en este navegador y no se envía a ningún sitio. Mi progreso