better bear

better-bear MCP server

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

MCP-Server und CLI für Bear-Notizen via CloudKit. Enthält eine Kontext-Bibliothek – einen kuratierten, synchronisierten Ordner mit Notizen, die für die Nutzung durch LLMs optimiert sind, inspiriert vom Muster von Karpathys LLM Knowledge Base.

Vollständige Dokumentation: better-bear.com

Installation

Installiere die CLI und verbinde sie dann mit Claude:

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

Dies installiert das bcli-Binary, authentifiziert sich bei iCloud und richtet den MCP-Server sowohl für Claude Desktop (via .mcpb-Bundle) als auch für Claude Code ein.

Andere Installationsmethoden

Methode	Befehl
Nur Claude Desktop	`bcli mcp install --desktop-only`
Nur Claude Code	`bcli mcp install --code-only`
Claude Code (direkt)	`claude mcp add better-bear -- npx -y better-bear`
Konfigurationsdatei	`bcli mcp install --json`
.mcpb-Bundle	Von der neuesten Version herunterladen und doppelklicken

Verwaltung

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

Alle Befehle funktionieren auch eigenständig über das 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

Siehe better-bear.com für die vollständige Befehlsreferenz.

Kontext-Bibliothek

Verwandle eine Teilmenge deiner Bear-Notizen in einen synchronisierten, kuratierten Kontextordner, den Claude mithilfe von indexbasierter Suche durchsuchen kann. Markiere Notizen in Bear mit #context, synchronisiere sie, und Claude liest einen kompakten Index, um relevante Dateien zu finden – es werden nur die benötigten Daten geladen, nicht alles.

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

Oder sage Claude: "Set up a context library" – und es erledigt alles über MCP-Tools.

Die Architektur folgt Karpathys Drei-Ordner-Muster: bear/ (synchronisiert von CloudKit), external/ (PDFs, Exporte, geteilte Dokumente) und inbox/ (Ablagebereich für die Sichtung). Ein index.md-Manifest bildet alles ab. Siehe better-bear.com für die vollständige Dokumentation.

MCP-Tools

34 Tools für Notizen, Tags, TODOs, Anhänge, Suche, Front-Matter, Statistiken, Gesundheitschecks und die Kontext-Bibliothek. Siehe die MCP-Server README für die vollständige Liste.