Bear Notes MCP-Server

Durchsuche, lies, erstelle und aktualisiere deine Bear-Notizen von jedem KI-Assistenten aus. Verfügbar als Claude Desktop-Erweiterung mit nur einem Klick und als eigenständiges npm-Paket für jeden MCP-Client.

Dieser lokale MCP-Server liest die SQLite-Datenbank von Bear für eine schnelle Suche mit OCR-Unterstützung und verwendet die native API von Bear für Schreibvorgänge. Vollständiger Datenschutz: keine externen Verbindungen, die gesamte Verarbeitung erfolgt auf deinem Mac.

Beispiel-Prompts:

Fasse unser Gespräch zusammen und erstelle eine neue Bear-Notiz daraus

Interviewe mich zu meiner Idee für ein Nebenprojekt und halte die wichtigsten Punkte in einer Bear-Notiz fest

Hilf mir, die Gliederung in meiner "Produkteinführung"-Notiz umzustrukturieren

Lass uns Ideen für Blogbeiträge sammeln – speichere die besten in meiner Bear-Notiz und verfeinere sie während wir arbeiten

✨ Hauptfunktionen

• 13 MCP-Tools zum Suchen, Lesen, Erstellen, Aktualisieren, Taggen und Archivieren von Notizen

• OCR-Suche – findet Text in angehängten Bildern und PDFs

• Datumsbasierte Suche mit relativen Datumsangaben ("gestern", "letzte Woche", "Anfang letzten Monats")

• Tag-Verwaltung – Tags als Baumstruktur auflisten, nicht getaggte Notizen finden, Tags zu Notizen hinzufügen

• Konvention für neue Notizen (optional) – Tags direkt nach dem Titel platzieren, anstatt am Ende

• Inhaltsersetzung (optional) – den gesamten Notizinhalt oder einen bestimmten Abschnitt ersetzen

• Nur lokal – keine Netzwerkaufrufe, alle Daten bleiben auf deinem Mac

📦 Installation

Claude Desktop-Erweiterung

Voraussetzungen: Die Bear-App muss installiert sein und Claude Desktop muss installiert sein.

1. Lade die neueste bear-notes-mcpb-*.mcpb Erweiterungsdatei von Releases herunter

2. Stelle sicher, dass dein Claude Desktop läuft (starte es, falls nicht)

3. Doppelklicke auf die Erweiterungsdatei – Claude Desktop sollte dir die Installationsaufforderung anzeigen

   Falls der Doppelklick aus irgendeinem Grund nicht funktioniert, öffne Claude -> Einstellungen -> Erweiterungen -> Erweiterte Einstellungen -> klicke auf "Erweiterung installieren".

4. FERTIG!

Bitte Claude, deine Bear-Notizen mit einer Abfrage wie "Suche in meinen Bear-Notizen nach 'Meeting'" zu durchsuchen – du solltest sehen, wie deine Notizen in der Antwort erscheinen!

Eigenständiger MCP-Server

Du möchtest diesen Bear Notes MCP-Server mit Claude Code, Cursor, Codex oder anderen KI-Assistenten verwenden?

Anforderungen: Node.js 24.13.0+

Claude Code (ein Befehl)

claude mcp add bear-notes --transport stdio -- npx -y bear-notes-mcp@latest

Andere KI-Assistenten

Füge dies zu deiner MCP-Konfigurationsdatei hinzu:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"]
    }
  }
}

Weitere Installationsoptionen und Einrichtung für die lokale Entwicklung — NPM.md

🛠️ Tools

• bear-open-note - Liest den vollständigen Textinhalt einer Bear-Notiz, einschließlich OCR-Text aus angehängten Bildern und PDFs

• bear-create-note - Erstellt eine neue Notiz in deiner Bear-Bibliothek mit optionalem Titel, Inhalt und Tags

• bear-search-notes - Findet Notizen durch Durchsuchen von Textinhalten, Filtern nach Tags oder Datumsbereichen. Beinhaltet OCR-Suche in Anhängen

• bear-add-text - Fügt Text am Anfang oder Ende einer Bear-Notiz oder innerhalb eines bestimmten, durch seine Überschrift identifizierten Abschnitts ein

• bear-replace-text - Ersetzt Inhalte in einer bestehenden Bear-Notiz – entweder den gesamten Textkörper oder einen bestimmten Abschnitt. Erfordert, dass die Inhaltsersetzung in den Einstellungen aktiviert ist.

• bear-add-file - Hängt eine Datei an eine bestehende Bear-Notiz an. Gib einen lokalen Dateipfad (bevorzugt) oder base64-kodierten Inhalt an.

• bear-list-tags - Listet alle Tags in deiner Bear-Bibliothek als hierarchischen Baum mit Notizanzahlen auf

• bear-find-untagged-notes - Findet Notizen in deiner Bear-Bibliothek, denen keine Tags zugewiesen sind

• bear-add-tag - Fügt einer bestehenden Bear-Notiz ein oder mehrere Tags hinzu

• bear-archive-note - Archiviert eine Bear-Notiz, um sie aus aktiven Listen zu entfernen, ohne sie zu löschen

• bear-rename-tag - Benennt ein Tag in allen Notizen deiner Bear-Bibliothek um

• bear-delete-tag - Löscht ein Tag aus allen Notizen deiner Bear-Bibliothek, ohne die Notizen zu beeinflussen

• bear-grab-url - Speichert eine Webseite als Bear-Notiz. Bear ruft die Seite ab und konvertiert sie in Markdown.

⚙️ Konfiguration

Debug-Protokollierung

Aktivieren der ausführlichen Protokollierung zur Fehlerbehebung.

• Claude Desktop: Einstellungen → Erweiterungen → Konfigurieren (neben Bear Notes) → "Debug-Protokollierung" umschalten → Speichern → Claude neu starten

• Eigenständiger MCP-Server: Umgebungsvariable UI_DEBUG_TOGGLE=true setzen

Konvention für neue Notizen

Standardmäßig platziert Bear Tags am Ende einer Notiz, wenn sie über die API erstellt wird. Aktiviere diese Option, um Tags stattdessen direkt nach dem Titel zu platzieren, getrennt durch eine horizontale Linie.

┌──────────────────────────────┐
│ # Meeting Notes              │  ← Note title
│ #work #meetings              │  ← Tags right after title
│                              │
│ ---                          │  ← Separator
│                              │
│ Lorem Ipsum...               │  ← Note body
└──────────────────────────────┘

• Claude Desktop: Einstellungen → Erweiterungen → Konfigurieren (neben Bear Notes) → "Konvention für neue Notizen" umschalten → Speichern → Claude neu starten

• Eigenständiger MCP-Server: Umgebungsvariable UI_ENABLE_NEW_NOTE_CONVENTION=true setzen

Beispiel für eine eigenständige Konfiguration mit aktivierter Konvention:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"],
      "env": {
        "UI_ENABLE_NEW_NOTE_CONVENTION": "true"
      }
    }
  }
}

Inhaltsersetzung

Aktiviert das Tool bear-replace-text, um Inhalte in bestehenden Notizen zu ersetzen – entweder den gesamten Notizkörper oder einen bestimmten Abschnitt unter einer Überschrift.

• Claude Desktop: Einstellungen → Erweiterungen → Konfigurieren (neben Bear Notes) → "Inhaltsersetzung" umschalten → Speichern → Claude neu starten

• Eigenständiger MCP-Server: Umgebungsvariable UI_ENABLE_CONTENT_REPLACEMENT=true setzen

Beispiel für eine eigenständige Konfiguration mit aktivierter Inhaltsersetzung:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"],
      "env": {
        "UI_ENABLE_CONTENT_REPLACEMENT": "true"
      }
    }
  }
}

Technische Details

Dieser Server liest deine Bear Notes SQLite-Datenbank direkt für Such-/Lesevorgänge und verwendet die X-callback-URL-API von Bear für Schreibvorgänge. Die gesamte Datenverarbeitung erfolgt lokal auf deinem Computer ohne externe Netzwerkaufrufe.

Unterstützte Plattformen

Nur macOS, da die Bear-Desktop-App nur unter macOS funktioniert.

Protokolle

Claude Desktop:

• MCP-Server-Protokolle befinden sich in ~/Library/Logs/Claude/main.log, suche nach bear-notes-mcp

• MCP-Transport-Protokolle befinden sich in ~/Library/Logs/Claude/mcp-server-Bear\ Notes.log

Eigenständiger MCP-Server:

• Protokolle werden nach stderr geschrieben; aktiviere die Debug-Protokollierung mit UI_DEBUG_TOGGLE=true

FAQ

Könnte dies meine Daten stehlen?

Nein. Der Server liest nur die lokale Datenbank von Bear (dieselben Daten, die dir die Bear-App anzeigt) und verwendet die native API von Bear, um Text zu den Notizen hinzuzufügen. Keine Netzwerkübertragung, keine externen Server.

Warum SQLite und nicht einfach die native x-callback-url API der Bear-App?

Für Lesevorgänge (Suchen/Öffnen) gibt die x-callback-url API die Notizdaten in der x-success-Antwort zurück: Das würde einen Server oder eine benutzerdefinierte Binärdatei erfordern, um x-success-Antworten zu verarbeiten – beides riskant und fehleranfällig. Der direkte schreibgeschützte SQLite-Zugriff ist einfacher und zuverlässiger für das Suchen und Lesen von Notizen.

Warum natives Node.js SQLite anstelle von Drittanbieter-Paketen?

Dies vermeidet die Auslieferung einer SQLite-Binärdatei aus Drittanbieter-Node-Paketen, was Lieferkettenrisiken birgt und verhindert, dass die Claude Desktop-Erweiterung unter macOS läuft.

Anthropic signiert keine SQLite-Binärdateien von Drittanbietern (offensichtlich), was dazu führt, dass macOS-Sicherheitssysteme melden, dass der Claude-Prozess, der von einer von Anthropic signierten Binärdatei stammt, versucht, eine andere von einem Drittanbieter signierte Binärdatei auszuführen. Infolgedessen kann Claude Desktop die Erweiterung nicht ausführen.

Wenn ich die Erweiterung installiere, sehe ich eine rote Warnung: "Die Installation gewährt Zugriff auf alles auf deinem Computer." – was bedeutet das?

So reagiert Claude for Desktop auf die Tatsache, dass diese Erweiterung Zugriff auf die Bear SQLite-Datenbank auf deinem Mac benötigt.

Das Warnsystem von Claude unterscheidet nicht zwischen der Notwendigkeit, nur auf eine Datei zuzugreifen (was die Erweiterung tut) und der Notwendigkeit, auf alle Dateien zuzugreifen (das ist NICHT, was die Erweiterung tut).

Eine Möglichkeit, dies zu validieren, besteht darin, deinen Claude zu bitten, die Codebasis (sie ist ziemlich klein) zu analysieren, bevor du die Erweiterung installierst.

Wie kann ich einen Fehler melden oder einen Beitrag leisten?

Nutze Issues oder Diskussionen! Ich würde mich über dein Feedback oder deine Vorschläge freuen, oder über deine Hilfe, dieses Projekt zu verbessern! ❤️

Auf dem Laufenden bleiben

Erwäge, Release-Ankündigungen zu abonnieren, um zu erfahren, wann eine neue Version veröffentlicht wird:

Ich poste auch auf reddit.com/r/bearapp/, wenn es eine neue Version gibt.