What is Apple Books Mcp

apple-books-mcp is a Model Context Protocol (MCP) server designed for Apple Books, enabling users to interact with their book collections and annotations effectively.

Use cases

Use cases for apple-books-mcp include students summarizing their study materials, avid readers organizing their libraries, and researchers comparing notes from various sources.

How to use

To use apple-books-mcp, you can call various functions such as listing collections, retrieving books, and searching annotations. Each function requires specific parameters, like collection IDs or book IDs, to fetch the desired information.

Key features

Key features of apple-books-mcp include the ability to summarize highlights, organize books by genre, recommend similar books based on reading history, and compare notes from different books on the same subject.

Where to use

apple-books-mcp can be used in educational settings, personal reading management, and any environment where users need to manage and analyze their reading materials effectively.

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.