Apple Books — MCP-сервер для Claude Code: что делает и как установить
Сервер открывает ИИ-ассистенту доступ к библиотеке Apple Books, цитатам, заметкам и статусу чтения на macOS.
claude mcp add --env APPLE_BOOKS_MCP_ENABLE_WRITES=<APPLE_BOOKS_MCP_ENABLE_WRITES> --env APPLE_BOOKS_DATA_DIR=<APPLE_BOOKS_DATA_DIR> --env APPLE_BOOKS_MCP_THREADS=<APPLE_BOOKS_MCP_THREADS> --env APPLE_BOOKS_QUERY_TIMEOUT=<APPLE_BOOKS_QUERY_TIMEOUT> --transport stdio apple-books -- uvx apple-books-mcpЧто делает Apple Books
Сервер подключается напрямую к локальной базе Apple Books на macOS. Он позволяет искать книги по авторам или названиям, проверять статус чтения и извлекать цитаты вместе с окружающим контекстом. Фрагменты текста из книг сервер возвращает внутри тегов <book_text>, чтобы ассистент не воспринимал содержимое как инструкции.
Запись по умолчанию отключена. Для создания полок и редактирования коллекций нужен флаг --enable-writes. Сервер блокирует любые изменения базы, если приложение «Книги» открыто прямо сейчас, а перед каждой записью сохраняет резервную копию в папку ~/.py_apple_books/backups/. Если на Mac включена синхронизация с iCloud, изменённые напрямую коллекции могут перезаписаться облаком при следующем обновлении.
Инструменты чтения глав работают только с локально сохранёнными файлами в формате EPUB. Книги с DRM-защитой или файлы, оставшиеся исключительно в iCloud, прочитать не получится.
Какие задачи решает
- найти цитаты и заметки по названию или идентификатору книги
- проверить списки начатых, прочитанных или отложенных книг
- вытащить фрагмент главы вокруг сделанной заметки
- создать пользовательскую коллекцию через флаг
--enable-writes
Примеры запросов агенту
- Какие книги я сейчас читаю в Apple Books?
- Найди все мои заметки и цитаты из книги с идентификатором 175.
- Покажи последние завершённые книги из моей библиотеки.
Как установить Apple Books
Командой платформы
claude mcp add --env APPLE_BOOKS_MCP_ENABLE_WRITES=<APPLE_BOOKS_MCP_ENABLE_WRITES> --env APPLE_BOOKS_DATA_DIR=<APPLE_BOOKS_DATA_DIR> --env APPLE_BOOKS_MCP_THREADS=<APPLE_BOOKS_MCP_THREADS> --env APPLE_BOOKS_QUERY_TIMEOUT=<APPLE_BOOKS_QUERY_TIMEOUT> --transport stdio apple-books -- uvx apple-books-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-books-mcp <команда>
Командой платформы
codex mcp add apple-books --env APPLE_BOOKS_MCP_ENABLE_WRITES=<APPLE_BOOKS_MCP_ENABLE_WRITES> --env APPLE_BOOKS_DATA_DIR=<APPLE_BOOKS_DATA_DIR> --env APPLE_BOOKS_MCP_THREADS=<APPLE_BOOKS_MCP_THREADS> --env APPLE_BOOKS_QUERY_TIMEOUT=<APPLE_BOOKS_QUERY_TIMEOUT> -- uvx apple-books-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-books-mcp <команда>
Файл настроек
{
"mcpServers": {
"apple-books": {
"command": "uvx",
"args": [
"apple-books-mcp"
],
"env": {
"APPLE_BOOKS_MCP_ENABLE_WRITES": "<APPLE_BOOKS_MCP_ENABLE_WRITES>",
"APPLE_BOOKS_DATA_DIR": "<APPLE_BOOKS_DATA_DIR>",
"APPLE_BOOKS_MCP_THREADS": "<APPLE_BOOKS_MCP_THREADS>",
"APPLE_BOOKS_QUERY_TIMEOUT": "<APPLE_BOOKS_QUERY_TIMEOUT>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-books-mcp <команда>
Файл настроек
{
"servers": {
"apple-books": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-books-mcp"
],
"env": {
"APPLE_BOOKS_MCP_ENABLE_WRITES": "<APPLE_BOOKS_MCP_ENABLE_WRITES>",
"APPLE_BOOKS_DATA_DIR": "<APPLE_BOOKS_DATA_DIR>",
"APPLE_BOOKS_MCP_THREADS": "<APPLE_BOOKS_MCP_THREADS>",
"APPLE_BOOKS_QUERY_TIMEOUT": "<APPLE_BOOKS_QUERY_TIMEOUT>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-books-mcp <команда>
Командой платформы
gemini mcp add -e APPLE_BOOKS_MCP_ENABLE_WRITES=<APPLE_BOOKS_MCP_ENABLE_WRITES> -e APPLE_BOOKS_DATA_DIR=<APPLE_BOOKS_DATA_DIR> -e APPLE_BOOKS_MCP_THREADS=<APPLE_BOOKS_MCP_THREADS> -e APPLE_BOOKS_QUERY_TIMEOUT=<APPLE_BOOKS_QUERY_TIMEOUT> apple-books uvx apple-books-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-books-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Books
Как установить Apple Books в Claude Code?
Выполните в терминале команду claude mcp add apple-books-mcp -- uvx apple-books-mcp.
Что делает MCP-сервер Apple Books?
Он передаёт языковой модели списки ваших книг, прогресс чтения, коллекции и сделанные пометки из Apple Books.
Почему сервер не может прочесть некоторые книги?
Чтение содержимого глав поддерживается только для незащищённых файлов EPUB, загруженных на диск. Книги с DRM или файлы, хранящиеся только в iCloud, сервер открыть не сможет.
