Cuaderno de bitácora para developers. Notas, TODOs con prioridades, recordatorios recurrentes, ADRs, debug sessions y búsqueda full-text FTS5. Modo SQLite u Obsidian.

28 de marzo de 2026

● GitHub ● npm

// tech stack

TypeScriptMCP SDKSQLiteFTS5Obsidian

10tools MCP

151tests

2modos storage

7topics integrados

¿Por qué logbook-mcp?

Los developers tomamos decisiones, resolvemos bugs y descubrimos cosas constantemente. Pero sin un sistema para registrarlo, ese conocimiento se pierde entre sesiónes. logbook-mcp es un cuaderno de bitácora que vive dentro de tu asistente AI.

TipFunciona en modo SQLite (zero config) o Obsidian (archivos markdown con frontmatter para tu vault).

Instalación

Terminal

claude mcp add --scope user logbook -- npx -y @cocaxcode/logbook-mcp@latest --mcp

Con Obsidian

claude mcp add --scope user logbook -- npx -y @cocaxcode/logbook-mcp@latest --mcp \
  --storage obsidian --dir "/path/to/vault/logbook"

¿Qué puedes hacer?

Notas rápidas

Registra hallazgos, ideas y progreso con topics: feature, fix, chore, idea, decision, blocker.

TODOs con prioridades

Crea TODOs con niveles low, normal, high y urgent. Batch operations para crear o completar varios a la vez.

Recordatorios

Recordatorios únicos o recurrentes: daily, weekdays, weekly:lunes, monthly:15. Se muestran automáticamente.

Decisiones (ADR)

Documenta decisiones arquitectónicas con contexto, opciones consideradas, decisión y consecuencias.

Debug sessions

Registra sesiónes de debug con error, causa raíz y solución aplicada. Historial consultable.

Búsqueda FTS5

Búsqueda full-text instantánea en notas y TODOs. Timeline cross-project para ver actividad global.

Ejemplo: flujo diario

Sesión típica

// Registrar lo que hiciste
logbook_entry: standup
  yesterday: "Implementé auth JWT"
  today: "Añadir refresh tokens"
  blockers: "Ninguno"

// Añadir un TODO urgente
logbook_todo: add
  content: "Revisar rate limiting en producción"
  priority: urgent

// Buscar algo que hiciste la semana pasada
logbook_query: search "rate limiting"

Topics integrados

Topic	Uso
feature	Nuevas funcionalidades
fix	Bugs corregidos
chore	Mantenimiento y limpieza
idea	Ideas para explorar
decision	Decisiones técnicas
blocker	Problemas que bloquean
reminder	Recordatorios activos

Así se ve en la práctica

Registrar una nota

Tu: "Apunta que el rate limiting de la API esta
     configurado a 100 req/min por IP"

MCP: logbook_note → topic: chore
IA: "Nota guardada en el topic 'chore'.
     Puedes buscarla luego con 'rate limiting'."

Crear TODO urgente

Tu: "Anade un TODO urgente: revisar los logs de produccion"

MCP: logbook_todo → add, priority: urgent
IA: "TODO creado con prioridad urgente.
     Aparecera destacado en el listado."

Registrar decisión arquitectónica

Tu: "Documenta que elegimos JWT sobre sessions porque
     necesitamos escalar horizontalmente"

MCP: logbook_entry → action: decision
IA: "Decision registrada (ADR):
     JWT sobre sessions — escalabilidad horizontal."

Sesión de debug

Tu: "El endpoint /users daba 500. Era un N+1 en la
     query de roles. Lo arregle con un JOIN."

MCP: logbook_entry → action: debug
IA: "Debug session guardada:
     Error: 500 en /users. Causa: N+1. Fix: JOIN."

Buscar en todo

Tu: "Busca todo lo que tenga que ver con autenticacion"

MCP: logbook_query → search "autenticacion"
IA: "3 resultados: 1 decision (JWT), 1 nota (rate limiting),
     1 TODO (revisar tokens expirados)."

Review semanal

Tu: "Genera el resumen de esta semana"

MCP: logbook_review → period: week
IA: "Semana: 12 notas, 5 TODOs completados, 2 decisiones.
     Highlights: migracion a JWT, fix N+1 en /users."

ObsidianEn modo Obsidian, cada nota es un archivo .md con frontmatter YAML. Compatible con plugins Dataview, Calendar, Tasks y Graph View.