NestDaddy

Apple Books

io.github.vgnshiyer/apple-books-mcp · v0.9.0

Access your Apple Books library, annotations, reading progress, and highlights through Claude

Connect Runs on your machine

Terminal
claude mcp add apple-books-mcp -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> -- uvx apple-books-mcp==0.9.0
claude_desktop_config.json
{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "uvx",
      "args": [
        "apple-books-mcp==0.9.0"
      ],
      "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>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "uvx",
      "args": [
        "apple-books-mcp==0.9.0"
      ],
      "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>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "apple-books-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-books-mcp==0.9.0"
      ],
      "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>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
APPLE_BOOKS_MCP_ENABLE_WRITES
Optional
Allow the collection write tools (create, rename and delete collections; add and remove books). Writes refuse to run while Books is open and take a backup first.
APPLE_BOOKS_DATA_DIR
Optional
Folder holding the Apple Books stores (BKLibrary and AEAnnotation), if not ~/Library/Containers/com.apple.iBooksX/Data/Documents.
APPLE_BOOKS_MCP_THREADS
Optional
How many tool calls may run at once (default 8; 0 runs them one at a time on the event loop).
APPLE_BOOKS_QUERY_TIMEOUT
Optional
Seconds a library query may run before it is stopped (default 30; 0 for no limit).

Details

Package[email protected] (PYPI, stdio)
Packagehttps://github.com/vgnshiyer/apple-books-mcp/releases/download/v0.9.0/[email protected] (MCPB, stdio)
First published1 Oct 2026
Last updated1 Oct 2026
Registry nameio.github.vgnshiyer/apple-books-mcp

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.