I
io.github.vgnshiyer/apple-books-mcp
Access your Apple Books library, annotations, reading progress, and highlights through Claude
ActiveNot tested
57CNo CVEsactive
Quick Install
{
"mcpServers": {
"apple-books-mcp": {
"args": [
"apple-books-mcp@latest"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Embed in your READMEAbout badges →
[](https://mcppedia.org/s/io-github-vgnshiyer-apple-books-mcp)
Should you use this server?
Model Context Protocol (MCP) server for Apple Books.
✓
Is it safe?
No known CVEs for apple-books-mcp.
No authentication — any process on your machine can connect.
License not specified.
✓
Is it maintained?
Last commit 1 days ago. 45 stars.
i
Will it work with my client?
Transport: stdio, sse. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
README
Apple Books MCP
Model Context Protocol (MCP) server for Apple Books.
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 |
| get_books_by_genre | Get books by genre (substring match) | genre: str, limit?: int |
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 |
| get_annotations_by_date_range | Get annotations within a date range | after?: YYYY-MM-DD, before?: YYYY-MM-DD, limit?: int |
Library Stats
| Tool | Description | Parameters |
|---|---|---|
| get_library_stats | Get library summary with reading stats | None |
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
Using Docker
docker run -v ~/Library/Containers/com.apple.iBooksX/Data/Documents:/root/Library/Containers/com.apple.iBooksX/Data/Documents:ro ghcr.io/vgnshiyer/apple-books-mcp:latest
Configuration
Claude Desktop Setup
Using uvx (recommended)
... [View full README on GitHub](https://github.com/vgnshiyer/apple-books-mcp#readme)
Test This Server
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'apple-books-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Score Breakdown
Security
20/30No known vulnerabilities.
✓
○
Tool safety — No tools to analyze
○
Tool poisoning — No tools to analyze
○
Injection vectors — No tools to analyze
✓
Tool stability — Tool definitions stable
○
Dependency health — found on deps.dev, recently updated
✗
License — No license specified
○
Authentication — No authentication required
○
Repository — active repo
CVEs checked daily via OSV.dev. Score algorithm is open source.
Reviews
Have you used this server?
Share your experience — it helps other developers decide.
How easy was setup?Did it work reliably?How was the documentation?
Sign in to write a review.
Frequently Asked Questions
- Is io.github.vgnshiyer/apple-books-mcp safe to use?
- io.github.vgnshiyer/apple-books-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
- How do I install io.github.vgnshiyer/apple-books-mcp?
- io.github.vgnshiyer/apple-books-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
- What AI clients work with io.github.vgnshiyer/apple-books-mcp?
- io.github.vgnshiyer/apple-books-mcp is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio and sse transport.
- Is io.github.vgnshiyer/apple-books-mcp actively maintained?
- io.github.vgnshiyer/apple-books-mcp is actively maintained — last commit was 1 day ago. It has 45 GitHub stars.
Similar servers
View all →
Sequential Thinking MCP Server
OfficialNo CVEs98A
Dynamic problem-solving through sequential thought chains
1 toolsstdio84.0k112.2k/wk2d ago
XcodeBuildMCP
OfficialNo CVEs97A
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
2 toolsremote5.2k46.6k/wk1d ago
Python Sdk
OfficialNo CVEs95A
The official Python SDK for Model Context Protocol servers and clients
1 toolsremote22.7k166.4k/wk13h ago
Gemini Cli
No CVEs95A
An open-source AI agent that brings the power of Gemini directly into your terminal.
8 toolsremote101.5k891.1k/wk5h ago
MCP Security Weekly
Get CVE alerts and security updates for io.github.vgnshiyer/apple-books-mcp and similar servers.
Discussion
Start a conversation
Ask a question, share a tip, or report an issue.
Has anyone used this with Cursor?How do you handle auth?Any alternatives?
Sign in to join the discussion.