Search / io.github.vgnshiyer/apple-books-mcp
protogridL0· runs locallyAccess your Apple Books library, annotations, reading progress, and highlights through Claude
v0.9.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"apple-books-mcp": {
"command": "uvx",
"args": [
"apple-books-mcp==0.9.0"
],
"env": {
"APPLE_BOOKS_MCP_ENABLE_WRITES": "false",
"APPLE_BOOKS_MCP_THREADS": "8",
"APPLE_BOOKS_QUERY_TIMEOUT": "30"
}
}
}
}claude mcp add apple-books-mcp -e "APPLE_BOOKS_MCP_ENABLE_WRITES=false" -e "APPLE_BOOKS_MCP_THREADS=8" -e "APPLE_BOOKS_QUERY_TIMEOUT=30" -- uvx apple-books-mcp==0.9.0[mcp_servers.apple-books-mcp]
command = "uvx"
args = ["apple-books-mcp==0.9.0"]
env = { "APPLE_BOOKS_MCP_ENABLE_WRITES" = "false", "APPLE_BOOKS_MCP_THREADS" = "8", "APPLE_BOOKS_QUERY_TIMEOUT" = "30" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"apple-books-mcp": {
"type": "local",
"command": [
"uvx",
"apple-books-mcp==0.9.0"
],
"enabled": true,
"environment": {
"APPLE_BOOKS_MCP_ENABLE_WRITES": "false",
"APPLE_BOOKS_MCP_THREADS": "8",
"APPLE_BOOKS_QUERY_TIMEOUT": "30"
}
}
}
}{
"mcpServers": {
"apple-books-mcp": {
"command": "uvx",
"args": [
"apple-books-mcp==0.9.0"
],
"env": {
"APPLE_BOOKS_MCP_ENABLE_WRITES": "false",
"APPLE_BOOKS_MCP_THREADS": "8",
"APPLE_BOOKS_QUERY_TIMEOUT": "30"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=apple-books-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJhcHBsZS1ib29rcy1tY3A9PTAuOS4wIl0sImVudiI6eyJBUFBMRV9CT09LU19NQ1BfRU5BQkxFX1dSSVRFUyI6ImZhbHNlIiwiQVBQTEVfQk9PS1NfTUNQX1RIUkVBRFMiOiI4IiwiQVBQTEVfQk9PS1NfUVVFUllfVElNRU9VVCI6IjMwIn19"
}{
"servers": {
"apple-books-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-books-mcp==0.9.0"
],
"env": {
"APPLE_BOOKS_MCP_ENABLE_WRITES": "false",
"APPLE_BOOKS_MCP_THREADS": "8",
"APPLE_BOOKS_QUERY_TIMEOUT": "30"
}
}
}
}{
"mcpServers": {
"apple-books-mcp": {
"command": "uvx",
"args": [
"apple-books-mcp==0.9.0"
],
"env": {
"APPLE_BOOKS_MCP_ENABLE_WRITES": "false",
"APPLE_BOOKS_MCP_THREADS": "8",
"APPLE_BOOKS_QUERY_TIMEOUT": "30"
}
}
}
}extensions:
"apple-books-mcp":
enabled: true
name: "apple-books-mcp"
type: stdio
cmd: "uvx"
args:
- "apple-books-mcp==0.9.0"
envs:
"APPLE_BOOKS_MCP_ENABLE_WRITES": "false"
"APPLE_BOOKS_MCP_THREADS": "8"
"APPLE_BOOKS_QUERY_TIMEOUT": "30"
timeout: 300
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknownNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-19d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] PyPIthis version is not known to the dependency resolver
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
apple-books-mcp | pypi | 0.9.0 | uvx | |
https://github.com/vgnshiyer/apple-books-mcp/releases/download/v0.9.0/apple-books-mcp-0.9.0.mcpb | mcpb | 0.9.0 | – |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.vgnshiyer/apple-books-mcp",
"title": "Apple Books",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.9.0",
"packages": [
{
"version": "0.9.0",
"transport": {
"type": "stdio"
},
"identifier": "apple-books-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "APPLE_BOOKS_MCP_ENABLE_WRITES",
"format": "boolean",
"default": "false",
"description": "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."
},
{
"name": "APPLE_BOOKS_DATA_DIR",
"format": "filepath",
"description": "Folder holding the Apple Books stores (BKLibrary and AEAnnotation), if not ~/Library/Containers/com.apple.iBooksX/Data/Documents."
},
{
"name": "APPLE_BOOKS_MCP_THREADS",
"format": "number",
"default": "8",
"description": "How many tool calls may run at once (default 8; 0 runs them one at a time on the event loop)."
},
{
"name": "APPLE_BOOKS_QUERY_TIMEOUT",
"format": "number",
"default": "30",
"description": "Seconds a library query may run before it is stopped (default 30; 0 for no limit)."
}
]
},
{
"version": "0.9.0",
"transport": {
"type": "stdio"
},
"fileSha256": "0fe18329889376b756716d14a3e6aa89374af7df1190504185632dcd68039fbc",
"identifier": "https://github.com/vgnshiyer/apple-books-mcp/releases/download/v0.9.0/apple-books-mcp-0.9.0.mcpb",
"registryType": "mcpb"
}
],
"repository": {
"id": "961227279",
"url": "https://github.com/vgnshiyer/apple-books-mcp",
"source": "github"
},
"websiteUrl": "https://vgnshiyer.me/AppleBooksMcp",
"description": "Access your Apple Books library, annotations, reading progress, and highlights through Claude"
}