MCP-сервер для Bear Notes

Ищите, читайте, создавайте и обновляйте свои заметки в Bear с помощью любого ИИ-ассистента. Доступен как расширение для Claude Desktop (установка в один клик) и как автономный npm-пакет для любого MCP-клиента.

Этот локальный MCP-сервер считывает базу данных SQLite приложения Bear для быстрого поиска с поддержкой OCR и использует нативный API Bear для записи. Полная конфиденциальность: никаких внешних подключений, вся обработка происходит на вашем Mac.

Примеры запросов:

Обобщи наш разговор и создай на его основе новую заметку в Bear

Проведи интервью по моей идее побочного проекта и зафиксируй ключевые моменты в заметке Bear

Помоги мне переструктурировать план в моей заметке "Запуск продукта"

Давай набросаем идеи для поста в блоге — сохрани лучшие из них в мою заметку Bear и дорабатывай их по ходу дела

✨ Ключевые особенности

• 13 инструментов MCP для поиска, чтения, создания, обновления, добавления тегов и архивирования заметок

• OCR-поиск — находит текст внутри прикрепленных изображений и PDF-файлов

• Поиск по дате с использованием относительных дат ("вчера", "на прошлой неделе", "в начале прошлого месяца")

• Управление тегами — список тегов в виде дерева, поиск заметок без тегов, добавление тегов к заметкам

• Конвенция новых заметок (опционально) — размещение тегов сразу после заголовка вместо нижней части заметки

• Замена содержимого (опционально) — замена всего текста заметки или конкретного раздела

• Только локально — никаких сетевых запросов, все данные остаются на вашем Mac

📦 Установка

Расширение для Claude Desktop

Предварительные требования: должны быть установлены приложение Bear и Claude Desktop.

1. Скачайте последний файл расширения bear-notes-mcpb-*.mcpb из раздела Releases

2. Убедитесь, что Claude Desktop запущен (если нет — запустите его)

3. Дважды щелкните по файлу расширения — Claude Desktop должен показать запрос на установку

   Если двойной щелчок по какой-то причине не работает, откройте Claude -> Settings -> Extensions -> Advanced Settings -> нажмите "Install Extension".

4. ГОТОВО!

Попросите Claude поискать ваши заметки в Bear с помощью запроса вроде "Search my Bear notes for 'meeting'" — вы должны увидеть свои заметки в ответе!

Автономный MCP-сервер

Хотите использовать этот MCP-сервер Bear Notes с Claude Code, Cursor, Codex или другими ИИ-ассистентами?

Требования: Node.js 24.13.0+

Claude Code (одна команда)

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

Другие ИИ-ассистенты

Добавьте в свой конфигурационный файл MCP:

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

Больше вариантов установки и настройки для локальной разработки — NPM.md

🛠️ Инструменты

• bear-open-note - Чтение полного текста заметки Bear, включая текст, распознанный с помощью OCR из прикрепленных изображений и PDF

• bear-create-note - Создание новой заметки в вашей библиотеке Bear с опциональными заголовком, содержимым и тегами

• bear-search-notes - Поиск заметок по тексту, фильтрация по тегам или диапазонам дат. Включает OCR-поиск во вложениях

• bear-add-text - Вставка текста в начало или конец заметки Bear, либо в конкретный раздел, идентифицированный по заголовку

• bear-replace-text - Замена содержимого в существующей заметке Bear — либо всего тела заметки, либо конкретного раздела. Требует включения функции замены содержимого в настройках.

• bear-add-file - Прикрепление файла к существующей заметке Bear. Укажите локальный путь к файлу (предпочтительно) или содержимое в формате base64.

• bear-list-tags - Список всех тегов в вашей библиотеке Bear в виде иерархического дерева с количеством заметок

• bear-find-untagged-notes - Поиск заметок в вашей библиотеке Bear, у которых нет назначенных тегов

• bear-add-tag - Добавление одного или нескольких тегов к существующей заметке Bear

• bear-archive-note - Архивация заметки Bear для удаления её из активных списков без удаления самой заметки

• bear-rename-tag - Переименование тега во всех заметках вашей библиотеки Bear

• bear-delete-tag - Удаление тега из всех заметок вашей библиотеки Bear без влияния на сами заметки

• bear-grab-url - Сохранение веб-страницы как заметки Bear. Bear загружает страницу и преобразует её в markdown.

⚙️ Конфигурация

Отладочное логирование

Включите подробное логирование для устранения неполадок.

• Claude Desktop: Settings → Extensions → Configure (рядом с Bear Notes) → переключите "Debug Logging" → Save → перезапустите Claude

• Автономный MCP-сервер: установите переменную окружения UI_DEBUG_TOGGLE=true

Конвенция новых заметок

По умолчанию Bear размещает теги в нижней части заметки при создании через API. Включите эту опцию, чтобы размещать теги сразу после заголовка, отделяя их горизонтальной линией.

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

• Claude Desktop: Settings → Extensions → Configure (рядом с Bear Notes) → переключите "New Note Convention" → Save → перезапустите Claude

• Автономный MCP-сервер: установите переменную окружения UI_ENABLE_NEW_NOTE_CONVENTION=true

Пример автономной конфигурации с включенной конвенцией:

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

Замена содержимого

Включите инструмент bear-replace-text для замены содержимого в существующих заметках — либо всего тела заметки, либо конкретного раздела под заголовком.

• Claude Desktop: Settings → Extensions → Configure (рядом с Bear Notes) → переключите "Content Replacement" → Save → перезапустите Claude

• Автономный MCP-сервер: установите переменную окружения UI_ENABLE_CONTENT_REPLACEMENT=true

Пример автономной конфигурации с включенной заменой содержимого:

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

Технические детали

Этот сервер считывает базу данных SQLite ваших заметок Bear напрямую для операций поиска/чтения и использует API X-callback-URL приложения Bear для операций записи. Вся обработка данных происходит локально на вашем компьютере без внешних сетевых вызовов.

Поддерживаемые платформы

Только macOS, так как десктопная версия Bear работает только на macOS.

Логи

Claude Desktop:

• Логи MCP-сервера находятся в ~/Library/Logs/Claude/main.log, ищите bear-notes-mcp

• Логи транспорта MCP находятся в ~/Library/Logs/Claude/mcp-server-Bear\ Notes.log

Автономный MCP-сервер:

• Логи записываются в stderr; включите отладочное логирование с помощью UI_DEBUG_TOGGLE=true

FAQ

Может ли это украсть мои данные?

Нет. Сервер только считывает локальную базу данных Bear (те же данные, которые показывает вам приложение Bear) и использует нативный API Bear для добавления текста в заметки. Никакой передачи по сети, никаких внешних серверов.

Почему SQLite, а не просто нативный API x-callback-url приложения Bear?

Для операций чтения (поиск/открытие) API x-callback-url возвращает данные заметки в ответе x-success: это потребовало бы сервера или специального бинарного файла для обработки ответов x-success — это рискованно и ненадежно. Прямой доступ к SQLite только для чтения проще и надежнее для поиска и чтения заметок.

Почему нативный Node.js SQLite, а не сторонние пакеты?

Это позволяет избежать поставки бинарного файла SQLite из сторонних пакетов node, что создает риски для цепочки поставок и блокирует работу расширения Claude Desktop на macOS.

Anthropic (очевидно) не подписывает сторонние бинарные файлы SQLite, из-за чего системы безопасности macOS помечают, что процесс Claude, подписанный Anthropic, пытается запустить другой бинарный файл, подписанный третьей стороной. В результате Claude Desktop не может запустить расширение.

Когда я устанавливаю расширение, я вижу красное предупреждение: "Установка предоставит доступ ко всему на вашем компьютере." — что это значит?

Так Claude для Desktop реагирует на тот факт, что этому расширению нужен доступ к базе данных SQLite приложения Bear на вашем Mac.

Система предупреждений Claude не различает необходимость доступа только к одному файлу (что и делает расширение) и необходимость доступа ко всем файлам (это НЕ то, что делает расширение).

Один из способов проверить это — попросить ваш Claude проанализировать кодовую базу (она довольно маленькая) перед установкой расширения.

Как я могу сообщить об ошибке или внести свой вклад?

Используйте issues или обсуждения! Буду рад вашим отзывам, предложениям или помощи в улучшении этого проекта! ❤️

Будьте в курсе

Рекомендую подписаться на анонсы релизов, чтобы знать, когда выходит новая версия:

Я также публикую информацию на reddit.com/r/bearapp/, когда выходит новый релиз.