better bear

better-bear MCP server

Build Release npm License: MIT better-bear MCP server Buy Me A Coffee

Servidor MCP y CLI para notas de Bear a través de CloudKit. Incluye una biblioteca de contexto: una carpeta seleccionada y sincronizada de notas optimizada para el consumo por parte de LLM, inspirada en el patrón de la Base de conocimientos de LLM de Karpathy.

Documentación completa: better-bear.com

Instalación

Instala la CLI y luego conéctate a Claude:

curl -sL https://raw.githubusercontent.com/KuvopLLC/better-bear/main/install.sh | bash
bcli auth
bcli mcp install

Esto instala el binario bcli, se autentica con iCloud y configura el servidor MCP tanto para Claude Desktop (a través del paquete .mcpb) como para Claude Code.

Otros métodos de instalación

Método	Comando
Solo Claude Desktop	`bcli mcp install --desktop-only`
Solo Claude Code	`bcli mcp install --code-only`
Claude Code (directo)	`claude mcp add better-bear -- npx -y better-bear`
Archivo de configuración	`bcli mcp install --json`
Paquete .mcpb	Descárgalo desde la última versión y haz doble clic

Gestión

bcli mcp status      # check what's configured
bcli mcp uninstall   # remove from Claude Desktop and Claude Code
bcli mcp reinstall   # clean uninstall + install
bcli upgrade         # upgrade bcli binary

CLI

Todos los comandos también funcionan de forma independiente desde la terminal:

bcli ls                          # list notes
bcli search "query"              # full-text search
bcli create "Title" -b "Body"    # create a note
bcli edit <id> --append "text"   # append to a note
bcli tags                        # list all tags
bcli attach <id> photo.jpg       # attach a file
bcli stats                       # library statistics
bcli health                      # health check

Consulta better-bear.com para ver la referencia completa de comandos.

Biblioteca de contexto

Convierte un subconjunto de tus notas de Bear en una carpeta de contexto sincronizada y seleccionada que Claude puede navegar utilizando la recuperación basada en índices. Etiqueta las notas con #context en Bear, sincroniza, y Claude leerá un índice compacto para encontrar los archivos relevantes, cargando solo lo que necesita, no todo.

bcli context init                          # one-time setup
bcli context sync                          # pull qualifying notes
bcli context add <id> --subtag research    # tag a note for inclusion
bcli context status                        # health check

O dile a Claude: "Set up a context library" (Configura una biblioteca de contexto), y él se encargará de todo mediante las herramientas MCP.

La arquitectura sigue el patrón de tres carpetas de Karpathy: bear/ (sincronizada desde CloudKit), external/ (PDFs, exportaciones, documentos compartidos) y inbox/ (zona de entrega para triaje). Un manifiesto index.md mapea todo. Consulta better-bear.com para obtener la documentación completa.

Herramientas MCP

34 herramientas que cubren notas, etiquetas, tareas pendientes (TODOs), archivos adjuntos, búsqueda, metadatos (front matter), estadísticas, comprobaciones de estado y la biblioteca de contexto. Consulta el README del servidor MCP para ver la lista completa.