# Save your TBR with an AI assistant

Reading Journey (RJ) gives your AI assistant a place to save your to-be-read list, or TBR. Books go into your Reading Journey account, so a connected assistant can retrieve them in a later conversation. You can also open your library on the web, iPhone, iPad or Android.

## From recommendation to saved book

Ask a connected assistant: “Add Piranesi by Susanna Clarke to my Reading Journey TBR.” The connector saves new books as **Want to Read** by default. If the book is already in your library, it returns the existing book and keeps its reading status.

Later, ask: “What's on my Reading Journey TBR?” or “Pick something from my Want to Read books for this weekend.” **Next Up** is a separate shortlist of up to five books you want to read soon. Collections let you group books by topic or reading plan.

The assistant needs your permission to connect to your account. Saving a recommendation requires a successful connector call; mentioning a book in a conversation does not save it.

## Connect your assistant

The connector is free and does not require RJ+. You need a Reading Journey account, but you do not need to install a mobile app. You can create an account during connection setup. Use the same sign-in method as your existing Reading Journey account to reach the same library.

- **Claude:** open the [Reading Journey directory listing](https://claude.ai/directory/reading-journey), choose **Connect**, then sign in and approve access.
- **ChatGPT and Meta Muse:** the connector supports these integrations. Availability and setup depend on the assistant's connector features. See the [assistant setup guide](https://readingjourney.co/docs/assistant/) and your assistant's connector settings.
- **Server address:** `https://mcp.readingjourney.app`
- **Your library:** [Open Reading Journey on the web](https://readingjourney.app/).

Changes reach the Reading Journey apps through normal sync. RJ+ adds sync on every device; using the connector itself is free.

## TBR tools for agents

The connector uses Model Context Protocol (MCP) over Streamable HTTP. After the reader connects, use MCP tool discovery for the current input schemas and server instructions.

| Reader's task | Tool | Behaviour |
| --- | --- | --- |
| Save a book for later | `add_book` | New books default to `want_to_read`. An existing ISBN or title and authors returns the existing book without resetting its status. |
| Retrieve the TBR | `list_books` with `status: "want_to_read"` | Returns books in the connected reader's library. Follow `nextCursor` with `cursor` to retrieve further pages. |
| See the shortlist | `get_next_up` | Returns the reader's Next Up books in order. |
| Put a saved book in the shortlist | `set_next_up` | Uses an existing book ID. Only books not yet started are eligible; the shortlist holds five books. |
| Organise books | `create_collection`, then `add_to_collection` | Groups saved books in the reader's own collections. |

When adding a book, supply its title and authors. Follow the server instructions for edition details and a cover; never invent an ISBN. If an existing book is returned, report its current status instead of claiming it was newly added. Reuse the same `requestId` when retrying a write within 24 hours. Show the returned `webUrl` so the reader can open the saved book.

See the [complete connector tool reference](https://readingjourney.co/connector) for inputs, permissions, limits and errors.

## Connecting another agent

The public server address is discoverable, but a custom MCP client is not automatically supported. OAuth client registration currently accepts approved callback URLs for Claude, ChatGPT and Meta Muse. Other clients need onboarding before they can connect. Contact hello@readingjourney.co with your client name and callback URL.

Supported clients use OAuth authorization code flow with PKCE (S256), then send the resulting access token as a Bearer token. The reader signs in and approves access in their browser. Never ask them to paste their Reading Journey password into the assistant.

- [OAuth authorization server metadata](https://mcp.readingjourney.app/.well-known/oauth-authorization-server)
- [OAuth protected resource metadata](https://mcp.readingjourney.app/.well-known/oauth-protected-resource)
- [Privacy policy](https://readingjourney.co/privacy/)

The connector accesses only the connected reader's library. It is not anonymous storage or a shared database of other readers' books.
