better-bear — MCP-сервер для Bear: заметки через CloudKit
MCP-сервер и CLI для заметок Bear: чтение, поиск, создание, правка и теги через CloudKit. Плюс папка контекста для LLM.
claude mcp add better-bear -- npx -y better-bearЧто делает better-bear
better-bear даёт агенту доступ к вашим заметкам в Bear. Через CloudKit сервер читает, ищет, создаёт и редактирует заметки, работает с тегами, вложениями, TODO и front matter. Всего 34 инструмента. Тот же набор команд доступен и из терминала через бинарник bcli.
Отдельная часть — контекстная библиотека. Помечаете нужные заметки тегом #context, синхронизируете, и агент читает компактный index.md, подгружая только релевантные файлы. Структура из трёх папок: bear/ с заметками из CloudKit, external/ для PDF и экспортов, inbox/ как зона разбора. Инициализация — bcli context init, дальше bcli context sync.
Перед первым запуском нужна авторизация в iCloud: bcli auth. Без неё сервер не получит доступ к заметкам. Установка идёт через curl -sL https://raw.githubusercontent.com/KuvopLLC/better-bear/main/install.sh | bash, затем bcli mcp install — так настраиваются Claude Desktop и Claude сразу. Для Claude есть и прямой путь: claude mcp add better-bear -- npx -y better-bear.
Какие задачи решает
- найти заметку по тексту, не открывая Bear
- создать заметку из ответа агента
- дописать текст в существующую заметку по id
- собрать папку контекста из отобранных заметок
- приложить файл к заметке
Примеры запросов агенту
- Найди в Bear заметки про архитектуру проекта
- Создай заметку «Итоги недели» с этим списком
- Настрой контекстную библиотеку из заметок с тегом
#context
Как установить better-bear
Командой платформы
claude mcp add better-bear -- npx -y better-bearКомандой платформы
codex mcp add better-bear -- npx -y better-bearФайл настроек
{
"mcpServers": {
"better-bear": {
"command": "npx",
"args": [
"-y",
"better-bear"
]
}
}
}Файл настроек
{
"servers": {
"better-bear": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"better-bear"
]
}
}
}Командой платформы
gemini mcp add better-bear npx -y better-bearПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о better-bear
Как установить better-bear в Claude Code?
Сначала поставьте CLI и авторизуйтесь: curl -sL https://raw.githubusercontent.com/KuvopLLC/better-bear/main/install.sh | bash, затем bcli auth. После этого выполните bcli mcp install — сервер пропишется и в Claude Desktop, и в Claude. Есть и прямой вариант: claude mcp add better-bear -- npx -y better-bear.
Что делает better-bear?
Даёт агенту доступ к заметкам Bear через CloudKit: чтение, поиск, создание, правка, теги, вложения, TODO и статистика. Плюс контекстная библиотека — отобранные заметки в виде папки с индексом для LLM.
Что нужно для работы better-bear?
Авторизация в iCloud через bcli auth — без неё доступа к заметкам не будет. Установщик ставит бинарник bcli, а сам сервер запускается через npx -y better-bear.
