Apple Books MCP
Model Context Protocol server for integrating and managing Apple Books data with AI assistants.
Key Features
Use Cases
README
Apple Books MCP
Model Context Protocol (MCP) server for Apple Books.
At a glance
- Ask Claude to summarize your recent highlights
- Ask Claude to organize books in your library by genre
- Ask Claude to recommend similar books based on your reading history
- Ask Claude to compare notes from different books read on the same subject
https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e
And much more!
Available Tools
| Tool | Description | Parameters |
|---|---|---|
| list_collections() | List all collections | None |
| get_collection_books(collection_id) | Get all books in a collection | collection_id: str |
| describe_collection(collection_id) | Get details of a collection | collection_id: str |
| list_all_books() | List all books | None |
| get_book_annotations(book_id) | Get all annotations for a book | book_id: str |
| describe_book(book_id) | Get details of a particular book | book_id: str |
| list_all_annotations() | List all annotations | None |
| get_highlights_by_color(color) | Get all highlights by color | color: str |
| search_highlighted_text(text) | Search for highlights by highlighted text | text: str |
| search_notes(note) | Search for notes | note: str |
| full_text_search(text) | Search for annotations containing the given text | text: str |
| recent_annotations() | Get 10 most recent annotations | None |
| describe_annotation(annotation_id) | Get details of an annotation | annotation_id: str |
Installation
Using uv (recommended)
uvx can be used to directly run apple-books-mcp (without installing it).
brew install uv # for macos
uvx apple-books-mcp
Using pip
pip install apple-books-mcp
After installing, you can run the server using:
python -m apple_books_mcp
Configuration
Claude Desktop Setup
Using uvx (recommended)
{
"mcpServers": {
"apple-books-mcp": {
"command": "uvx",
"args": [ "apple-books-mcp@latest" ]
}
}
}
Using python
{
"mcpServers": {
"apple-books-mcp": {
"command": "python",
"args": ["-m", "apple_books_mcp"]
}
}
}
Upcoming Features
- add docker support
- add resources support
- edit collections support
- edit highlights support
Contribution
Thank you for considering contributing to this project!
Development
If you cloned this repository, you can test it using Claude Desktop with below configuration:
Use uv venv to create a virtual environment and install the dependencies.
uv venv
uv sync
Debugging
With Claude Desktop
{
"mcpServers": {
"apple-books-mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/apple-books-mcp/",
"run",
"apple_books_mcp",
"-v"
]
}
}
}
With inspector
npx @modelcontextprotocol/inspector uvx apple-books-mcp
Opening Issues
If you encounter a bug, have a feature request, or want to discuss something related to the project, please open an issue on the GitHub repository. When opening an issue, please provide:
Bug Reports: Describe the issue in detail. Include steps to reproduce the bug if possible, along with any error messages or screenshots.
Feature Requests: Clearly explain the new feature you'd like to see added to the project. Provide context on why this feature would be beneficial.
General Discussions: Feel free to start discussions on broader topics related to the project.
Contributing
1️⃣ Fork the GitHub repository https://github.com/vgnshiyer/apple-books-mcp
2️⃣ Create a new branch for your changes (git checkout -b feature/my-new-feature).
3️⃣ Make your changes and test them thoroughly.
4️⃣ Push your changes and open a Pull Request to main.
Please provide a clear title and description of your changes.
License
Apple Books MCP is licensed under the Apache 2.0 license. See the LICENSE file for details.
Star History
Repository Owner
User
Repository Details
Programming Languages
Topics
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Ebook-MCP
A Model Context Protocol server for conversational e-book interaction and AI integration.
Ebook-MCP acts as a Model Context Protocol (MCP) server enabling seamless interaction between large language model (LLM) applications and electronic books such as EPUB and PDF. It standardizes APIs for AI-powered reading, searching, and managing digital libraries. Through natural language interfaces, it provides smart library management, content navigation, and interactive learning within digital books. Ebook-MCP integrates with modern AI-powered IDEs and supports multi-format digital book processing.
- ⭐ 132
- MCP
- onebirdrocks/ebook-mcp
MCP Obsidian Server
Integrate Obsidian note management with AI models via the Model Context Protocol.
MCP Obsidian Server acts as a bridge between Obsidian and AI models by providing an MCP-compatible server interface. It enables programmatic access to Obsidian vaults through a local REST API, allowing operations like listing files, searching, reading, editing, and deleting notes. Designed to work with Claude Desktop and other MCP-enabled clients, it exposes a set of tools for efficient note and content management within Obsidian.
- ⭐ 2,394
- MCP
- MarkusPfundstein/mcp-obsidian
MCP Manager for Claude Desktop
A desktop app to manage Model Context Protocol (MCP) servers for Claude Desktop on MacOS.
MCP Manager for Claude Desktop provides a user-friendly interface to manage Model Context Protocol (MCP) servers, enabling Claude to access private data, APIs, and local or remote services securely from a MacOS desktop. It facilitates rapid configuration and integration with a wide variety of MCP servers, including productivity tools, databases, and web APIs. The app runs locally to ensure data privacy and streamlines connecting Claude to new sources through simple environment and server settings management.
- ⭐ 270
- MCP
- zueai/mcp-manager
Apple Notes MCP Server
Enables Claude Desktop to access and interact with local Apple Notes.
Apple Notes MCP Server reads and provides access to local Apple Notes databases for use in Claude Desktop. It allows querying all notes, retrieving specific note content, and searching notes, facilitating deeper context integration for AI workflows. The server operates under the Model Context Protocol (MCP) and is designed for straightforward installation and integration. Currently, it supports reading and searching but does not handle encrypted notes, attachments, or note creation/editing.
- ⭐ 121
- MCP
- sirmews/apple-notes-mcp
Bear MCP Server
MCP server for accessing and searching Bear Notes on macOS.
Bear MCP Server is an implementation of the Model Context Protocol that provides programmatic access to notes and tags stored in Bear Notes on macOS. It enables users to read, search, and list notes and tags via standardized MCP tools. The server connects to Bear's SQLite database and exposes essential commands for integration with AI models and workflows.
- ⭐ 40
- MCP
- akseyh/bear-mcp-server
Bear MCP Server
Read-only Model Context Protocol server for Bear note integration
Bear MCP Server provides a Model Context Protocol (MCP) interface to access notes and tags stored in the Bear note-taking app. It enables AI assistants, including Claude, to securely interact with Bear notes through read-only operations, connecting directly to the Bear SQLite database without the risk of modifying user data. The server exposes tools for searching, opening, and listing notes and tags, ensuring all access is non-destructive.
- ⭐ 14
- MCP
- bart6114/my-bear-mcp-server
Didn't find tool you were looking for?