second-brain-mcp

Español · English

Tu segundo cerebro, en tu Obsidian, hablando con tu asistente.

Esto es un servidor MCP que convierte una carpeta de Markdown en un second brain de verdad: capturas lo que lees, lo conviertes en ideas con tus palabras, y esas ideas se conectan entre sí hasta formar un grafo que piensa contigo: cuando trabajas en algo, las notas relacionadas aparecen solas.

Todo en castellano. Todo en ficheros tuyos. Sin bases de datos, sin nube, sin magia que no puedas abrir con un editor de texto.

¿Cómo se siente?

Le dices a tu asistente:

«Estoy leyendo Hábitos Atómicos, apunta esto: el entorno decide más que la fuerza de voluntad»

y él crea la lectura si no existía, guarda el apunte, y cuando esa idea madure la convierte en una nota permanente conectada al concepto [[Hábitos]], que a su vez acumula todo lo que has pensado sobre el tema, venga del libro que venga.

Semanas después, trabajando en otra cosa, preguntas por diseñar tu rutina de mañanas y el sistema te trae de vuelta «El entorno decide por ti» con el párrafo exacto. Eso es el segundo cerebro: no recordar tú, que recuerde él.

El mapa

Cada etiqueta es método / qué es; en las dos puertas principales va también la frase que lo dispara:

                             tú + tu asistente
                                  │      ▲
                ingerir / ingesta │      │ resurgir / recuerdo
                   «añade esto»   ▼      │   «¿qué sé de esto?»
                           ┌──────────────┐
                           │ second-brain │
                           └───────┬──────┘
                     clasifica lo que entra
       ┌───────────────────────────┼───────────────────────────┐
       │ lectura_crear / ficha     │ nota_permanente / idea    │ mini_nota / apunte
       │ lectura_nota / apuntes    │                           │
       ▼                           ▼                           ▼
┌──────────────┐            ┌─────────────┐           ┌────────────────┐
│ 40-Lecturas/ │            │  50-Notas/  │           │ proyecto/brain/│
│ lo que entra │            │ lo que queda│           │ el taller      │
└──────┬───────┘            └──────┬──────┘           └────────┬───────┘
       │                           │                           │
       │ nota_permanente /         │ temas                     │ mini_promover /
       │ la idea madura            │                           │ madura o resuena
       └──────────────────────────▶│───────────┐               │
                                   │           ▼               │
              nota_enlazar /       │   ┌───────────────┐       │
              relacionar con       │   │ 60-Conceptos/ │◀──────┘
              motivo (2-3 máx)     ▼   │ lo que conecta│
                             otras ideas└───────────────┘

     jardin / poda «¿cómo está el jardín?» · concepto_fusionar / coser nodos
     vault_buscar / grep «busca dónde dije X» · mini_listar / cosecha del taller

Instalación

Lo más rápido: una línea, sin configurar nada

Si usas Claude Code:

claude mcp add --scope user second-brain -- npx -y @toportal/second-brain-mcp

Con cualquier otro cliente MCP:

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": ["-y", "@toportal/second-brain-mcp"]
    }
  }
}

Sin variables de entorno y sin decidir nada: tu cerebro se monta en ~/second-brain, con las tres carpetas y la portada listas. Dile a tu asistente «hazme el onboarding de mi second brain» y ya estás dentro.

¿Prefieres que viva en tu vault de Obsidian de siempre? Añade BRAIN_VAULT=/ruta/a/tu/vault y punto — el servidor solo escribe en tres subcarpetas y no toca nada más. Y si ya empezaste en el vault por defecto, mueve la carpeta a donde quieras y apunta BRAIN_VAULT allí: son ficheros Markdown, no hay nada que migrar.

Sin terminal: doble clic y listo

Si usas Claude Desktop y no quieres saber nada de comandos ni de JSON, descarga second-brain.mcpb y haz doble clic: Claude Desktop lo abre, te pide elegir la carpeta donde vivirá tu cerebro (tu vault de Obsidian si tienes, o una carpeta vacía cualquiera) y ya está. No necesitas instalar Node ni tocar ningún fichero de configuración. Y si además quieres ver tu cerebro dibujado como un grafo, instala Obsidian y abre esa misma carpeta como vault.

Con terminal, eligiendo tú la carpeta

Necesitas Node 18 o más nuevo. Con Claude Code, a nivel de usuario (disponible en todos tus proyectos):

claude mcp add --scope user second-brain \
  --env BRAIN_VAULT=/ruta/a/tu/vault \
  -- npx -y @toportal/second-brain-mcp

Con cualquier otro cliente MCP:

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": ["-y", "@toportal/second-brain-mcp"],
      "env": { "BRAIN_VAULT": "/ruta/a/tu/vault" }
    }
  }
}

Y listo. La primera nota crea las carpetas que hagan falta.

Una salvaguarda: si la ruta que configuras no existe y su carpeta contenedora tampoco, el servidor da por hecho que es un error al escribirla y te lo dice en la conversación en vez de plantarte un vault en una carpeta fantasma. Si el padre existe, la crea sin preguntar: eso es lo que querías.

Si prefieres dejar el vault montado desde el principio (carpetas + portada), hay andamiaje:

npx -y @toportal/second-brain-mcp --init /ruta/a/tu/vault

Es idempotente: sobre un vault que ya existe no toca nada.

Variables de entorno

Tu primera sesión

No te la tienes que inventar: dile a tu asistente «hazme el onboarding de mi second brain» (es el prompt empezar; en Claude Code aparece como el comando /mcp__second-brain__empezar) y él te guía paso a paso: mira cómo está tu vault, planta contigo la primera lectura y la primera idea con tus propias palabras, te enseña qué devuelve resurgir con tu material, y te deja la chuleta de los tres gestos del día a día. Si el vault ya tiene contenido no te trata de nuevo: te hace un tour de lo que hay.

Pruébalo en 30 segundos

El repo trae un vault de ejemplo ya tejido en ejemplo/, con dos lecturas, cuatro ideas y cuatro conceptos conectados entre sí, así que puedes ver el grafo funcionando antes de haber escrito una sola nota tuya:

git clone https://github.com/Portaltocoding/second-brain-mcp
cd second-brain-mcp && npm install
claude mcp add second-brain --env BRAIN_VAULT=$PWD/ejemplo -- node src/server.js

Y le preguntas a tu asistente algo como «¿qué sé yo sobre la fuerza de voluntad?». También puedes abrir la carpeta ejemplo/ como vault en Obsidian y ver el grafo dibujado.

Una sesión de verdad

Así se ve el día a día, sin aprenderse ninguna tool:

Tú: añade esto a mi second brain, lo más importante: "llevo semanas notando que si dejo el móvil en otra habitación por la mañana me salen dos horas de trabajo del tirón, y si lo tengo al lado voy a rachas de diez minutos entre miradas"

Asistente: esto es un pensamiento tuyo ya digerido, así que va como nota permanente en modo destilar. La idea fuerte que veo: «La distancia física al móvil marca la profundidad del trabajo», con los conceptos Foco y Entorno, que ya existen en tu grafo. ¿La creo así?

Tú: dale

Asistente: creada. Y resuena fuerte con «El foco se diseña, no se invoca» (score 8): las dos hablan de preparar el entorno en vez de confiar en la voluntad. ¿Las enlazo con ese motivo?

Tú: sí

Asistente: enlazadas, motivo escrito en las dos. Te dejo el enlace para abrirla en Obsidian: obsidian://open?path=...

Fíjate en el orden: el asistente propone, tú decides, y cada conexión queda con su porqué escrito. Eso es todo el sistema.

Las tres carpetas

tu-vault/
├── 40-Lecturas/     lo que entra: libros, artículos, vídeos, cursos
├── 50-Notas/        lo que queda: ideas permanentes, tuyas, con tu título
└── 60-Conceptos/    lo que conecta: cada tema es una nota real con backlinks

La regla de oro: nada entra suelto. Cada idea se enlaza a su origen, a los conceptos que toca y, con moderación, a otras ideas. Y la moderación importa: máximo 2-3 notas relacionadas, cada enlace con su porqué escrito. Un cajón con doce enlaces no conecta nada; tres enlaces con motivo son un mapa.

Qué sabe hacer

Capturar. lectura_crear abre la ficha de un libro o artículo; lectura_nota guarda apuntes mientras lees («cap 3: ...»); cuando una idea es tuya de verdad, nota_permanente la sube a 50-Notas/ con sus temas convertidos en conceptos navegables. nota_enlazar une dos ideas y deja escrito por qué.

Pensar. resurgir es el corazón: le das un texto (una tarea, una duda, una idea a medias) y te devuelve las notas más conectadas con él. Solo aparece cuando hay solape real; si no hay nada, no inventa. vault_buscar es el grep de toda la vida, acotado para no inundar (20 resultados y te avisa si hubo más).