Apple Books MCP — ваши книги и заметки в Claude
Apple Books MCP
MCP-сервер для Apple Books на macOS: агент видит текущую книгу, читает главы, выделения и заметки, ищет книги
- 64 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент читает ваши выделения, заметки и полные тексты глав, а они уходят провайдеру модели
- При флаге --enable-writes сервер правит базу Apple Books напрямую, и коллекции могут откатиться из iCloud
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/apple-books-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает ваши выделения, заметки и полные тексты глав, а они уходят провайдеру модели
- При флаге --enable-writes сервер правит базу Apple Books напрямую, и коллекции могут откатиться из iCloud
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер читает локальную библиотеку Apple Books и отдает ее агенту. Инструмент get_current_reading_position возвращает главу, на которой вы остановились, а get_chapter_content выдает текст главы с нарезкой через offset и max_chars. list_book_chapters показывает оглавление. Поиск работает по названию и автору без учета регистра, акцентов и типографских кавычек. Для выделений есть list_annotations, search_notes, search_annotations, get_highlights_by_color и get_annotation_context: последний возвращает абзац вокруг выделения с отметкой «...» на выбранном месте. Статусы чтения дают get_books_in_progress, get_finished_books, get_unstarted_books и get_recently_read_books, а get_library_stats считает сводку. Редактирование коллекций выключено по умолчанию и включается флагом --enable-writes: перед записью сервер делает резервную копию базы и отказывается работать при запущенном приложении Books. Текст из книг сервер помечает как недоверенные данные.
Для кого. Читателям на Mac, которые ведут книги и выделения в Apple Books и хотят обсуждать прочитанное с агентом.
Подходит, если
- Нужно вспомнить, о чем была глава, на которой вы остановились, и получить краткий пересказ
- Выделения из книги стоит собрать и сгруппировать по темам
- Хочется найти все заметки по слову за выбранный период
- Требуется обзор библиотеки: сколько книг прочитано, читается и лежит нетронутыми
Не подходит, если
- Нужна Windows, Linux или iPhone: сервер читает только локальную базу Apple Books на macOS
- Книга не скачана на этот Mac: текст главы недоступен, придет сообщение об ошибке
- Нужны книги из других читалок, например Kindle: сервер работает только с Apple Books
Пример запроса к агенту
Покажи, на какой главе я остановился в текущей книге, перескажи ее и собери мои выделения из этой книги по темам.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
APPLE_BOOKS_MCP_ENABLE_WRITES- Значение 1 включает редактирование коллекций
APPLE_BOOKS_DATA_DIR- Папка Documents приложения Apple Books
Ограничения
Работает только на macOS, Apple Books нужно открыть хотя бы раз, чтобы появилась библиотека. Нужен Python 3.10 и новее, первый запуск через uvx скачивает около 14 МБ и может занять минуту, что близко к времени ожидания Claude, поэтому один раз запустите uvx apple-books-mcp --version в терминале заранее. У Apple Books нет интерфейса автоматизации для коллекций, поэтому режим записи правит базу напрямую. При включенной синхронизации iCloud правки коллекций могут не дойти до других устройств и откатиться. Вариант с Docker помечен устаревшим.
Как отключить. Выполните claude mcp remove apple-books-mcp либо удалите расширение .mcpb в Claude Desktop. Резервные копии базы лежат в каталоге ~/.py_apple_books/backups, их можно стереть вручную.
Частые вопросы
Какая система нужна?
macOS с Apple Books, которую открывали хотя бы раз, и Python 3.10 или новее. Через uvx и расширение Claude Desktop нужный Python приходит автоматически.
Может ли агент менять мою библиотеку?
Нет, пока вы не добавите флаг --enable-writes. Тогда доступны create_collection, rename_collection, delete_collection и добавление книг, но каждая запись делает копию базы и не идет при открытом Books.
Как найти книгу?
Через search_books по названию или автору: поиск игнорирует регистр, акценты и кавычки, а результат содержит ссылку для открытия книги в Apple Books. Идентификатор из строки результата передают в другие инструменты.
Как получить текст текущей главы?
Вызовите get_chapter_content, передав current в параметре chapter_id. Для больших глав используйте offset и max_chars, чтобы читать частями.
Откуда сервер берет данные?
Из локальных баз Apple Books, папки с BKLibrary и AEAnnotation. Папку можно переопределить переменной APPLE_BOOKS_DATA_DIR, таймаут запроса задает APPLE_BOOKS_QUERY_TIMEOUT.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Apple Notes на Mac: агент читает, ищет, создает, правит и выгружает заметки, управляет папками и тегами.
Локальная читальня для Claude: книга EPUB или TXT режется на фрагменты, а заметки на полях и прогресс сохраняются между сессиями.
MCP-сервер для WeChat Reading: ИИ-агент получает вашу книжную полку, заметки, подчеркивания и популярные отзывы
MCP-сервер для вики BookStack: поиск и чтение по умолчанию, запись включается отдельно, права берутся из токена.
MCP-сервер для Apple Mail на macOS: поиск, чтение, черновики, правила и вложения, опасные шаги с подтверждением.
Локальный MCP-сервер для Mac: Claude, Codex и ChatGPT работают в приложениях, файлах, терминале и браузере по разрешениям
Коротко о README
В README перечислены сценарии, инструменты по группам с параметрами, правила работы с результатами и режим записи с защитой. Отдельно расписаны установка через uv, pip и расширение .mcpb, настройка Claude Desktop и Claude Code, переменные окружения и частые проблемы.