Skillget

apple-books-mcp

mcp
Guvenlik Denetimi
Gecti
Health Gecti
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 45 GitHub stars
Code Gecti
  • Code scan — Scanned 7 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This MCP server acts as a bridge to your local Apple Books library, allowing AI assistants to query your reading activity. It enables users to ask an LLM to summarize highlights, track reading progress, and search through book annotations.

Security Assessment
Overall Risk: Low. The tool requires read-only access to your local Apple Books SQLite databases to function. The automated code scan of 7 files found no dangerous patterns, hardcoded secrets, or requests for dangerous system permissions. Because it interacts with personal data (book titles, reading habits, and personal notes), there is an inherent privacy consideration. However, since the server appears to simply query local files rather than execute arbitrary shell commands or make suspicious external network requests, the technical security risk remains minimal.

Quality Assessment
The project exhibits strong signs of good health and reliability. It is actively maintained, with the most recent code push occurring today. It uses the permissive Apache 2.0 license, which is excellent for open-source adoption and legal clarity. Furthermore, it has garnered 45 GitHub stars, indicating a solid baseline of community trust and interest from other developers.

Verdict
Safe to use.
SUMMARY

Apple Books MCP Server

README.md

Apple Books MCP

Model Context Protocol (MCP) server for Apple Books.


PyPI
License: Apache 2.0

Buy Me A Coffee

At a glance

  • Ask Claude to summarize your recent highlights
  • Ask Claude what books you're currently reading and your progress
  • Ask Claude to find a book by title
  • 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

Collections

Tool Description Parameters
list_all_collections List all collections limit?: int
get_collection_books Get all books in a collection collection_id: str
describe_collection Get details of a collection collection_id: str
search_collections_by_title Search for collections by title title: str

Books

Tool Description Parameters
list_all_books List all books limit?: int
describe_book Get details of a particular book book_id: str
get_book_annotations Get all annotations for a book book_id: str
search_books_by_title Search for books by title title: str

Reading Status

Tool Description Parameters
get_books_in_progress Get books currently being read limit?: int
get_finished_books Get books that have been finished limit?: int
get_unstarted_books Get books not yet started limit?: int
get_recently_read_books Get most recently opened books limit?: int (default: 10)

Annotations

Tool Description Parameters
list_all_annotations List all annotations limit?: int
recent_annotations Get most recent annotations limit?: int (default: 10)
describe_annotation Get details of an annotation annotation_id: str
get_highlights_by_color Get all highlights by color color: str, limit?: int
search_highlighted_text Search highlights by text text: str, limit?: int
search_notes Search annotations by note note: str, limit?: int
full_text_search Search annotations by any text text: str, limit?: int

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.

Yorumlar (0)

Sonuc bulunamadi