Access book collections, reading lists, and bookshelf recognition from AI assistants.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
π‘ Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Access SPINES book collections, reading lists, and bookshelf data from AI assistants via the Model Context Protocol.
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Add to your MCP settings:
| Variable | Required | Default | Description |
|---|---|---|---|
SPINES_API_KEY | Yes | - | Your API key |
SPINES_API_URL | No | https://spins.app/api/v1 | API base URL |
SPINES_DEBUG | No | false | Verbose logging to stderr |
| Tool | Description |
|---|---|
search_books | Search for books by title, author, or ISBN |
get_book_details | Get full details for a specific book |
get_collection | Get a book collection with all its books |
list_collections | List your collections with optional filters |
list_categories | List all approved book categories |
get_persona | Get details about a persona |
| Tool | Description |
|---|---|
add_to_reading_list | Add a book to a reading list |
remove_from_reading_list | Remove a book from a reading list |
search_booksget_book_detailsget_collectionlist_collectionsadd_to_reading_listremove_from_reading_list| URI | Description |
|---|---|
spines://collection/{id} | A book collection with metadata |
spines://book/{id} | Full book details |
spines://persona/{id} | Persona profile and collections |
spines://reading-lists | User's reading lists |
| Prompt | Description |
|---|---|
analyze_shelf | Analyze a collection for themes and reading patterns |
recommend_books | Get recommendations based on your library |
compare_collections | Compare two collections for similarities |
| Problem | Solution |
|---|---|
| "SPINES_API_KEY is required" | Set the env var in your MCP client config |
| 401 errors | Check your API key is valid and not expired |
| 403 errors | Your key may lack required scopes |
| 429 errors | Rate limited β wait and retry |
| Tools not appearing | Restart your MCP client |
MIT
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/spines)<a href="https://allmcps.com/mcp/spines"><img src="https://allmcps.com/api/badge/spines?style=directory" alt="Spines on AllMCPs" /></a>