Liseursync

Ask about the book you are reading

Connect ChatGPT, or any assistant that speaks MCP, to your own server. It can tell you who a character is, what the last chapter said or what you highlighted. A search can use your saved reading position as a cutoff.

It can only read. Your server decides which assistants may ask, and you decide what each one sees.

I'm back after a week away. Who is Razumikhin again?

Followed “Razumikhin” through Crime and Punishment, up to your place

Raskolnikov's friend from university, who scrapes a living from translation work. When Raskolnikov fell ill with fever, Razumikhin found him and looked after him with the doctor Zossimov.

In the chapters you just read he met Raskolnikov's mother and his sister Dunya, and he is plainly taken with Dunya.

Each mark is a place the name appears. In this example, the assistant searches up to the saved position.

Things you can ask

Ask in your own words. The assistant works out which part of your library to look at.

“Make me a list of the characters so far, with one line each.”

The assistant can search for names up to your saved position and read the text around each mention.

“Remind me what happened just before I stopped.”

The assistant can read around the position Liseur, KOReader or the web reader last saved.

“What did I highlight in Middlemarch, and how do those passages connect?”

It sees your highlights and notes in reading order and can read the paragraph around any of them.

“How much did I read this month, and when will I finish at this pace?”

Reading time, streaks, pages and the time left in each book, counted in your own timezone.

“Which books in this series haven't I started?”

It searches your library and lists a series in order. It only sees the folders you can see yourself.

“Quiz me on the words I looked up last week.”

Saved words, definitions, notes and example sentences while reading, with their definitions and the sentence you met them in.

Connect ChatGPT

The first step happens once per server. After that each reader connects their own ChatGPT account.

  1. Turn it on

    Whoever runs the server sets enabled = true and public_url in the [mcp] section of the configuration and restarts it, then presses Allow ChatGPT under Settings, Administration, AI assistants.

  2. Add your server in ChatGPT

    Open chatgpt.com/plugins, press the plus button and choose Add custom MCP server. Give it a name, paste your server's address followed by /mcp and choose OAuth.

  3. Say yes on your server

    ChatGPT opens your server's sign-in page. Untick anything you would rather keep to yourself, such as book text or statistics, and press Allow.

Other assistants

Any client that connects to remote MCP servers with OAuth can use it, such as Claude, a coding agent in your editor or a script of your own. Give it the same address ending in /mcp. It finds the sign-in page by itself.

Your server only answers applications its administrator allowed. If the application publishes a client metadata document, allow that document's URL on the AI assistants admin page. If it does not, register it there by hand and copy the client ID into the application, along with the secret if it needs one. The secret is shown once.

Developers will find the full flow, the scopes and the limits in docs/integrating.md.

# the address to give an assistant
https://books.example.com/mcp

# what it then finds by itself
/.well-known/oauth-protected-resource/mcp
/.well-known/oauth-authorization-server
What a reader can grant
Your librarySearch books, see a book's details, list a series in order
Your readingReading positions, highlights and notes, including excerpts
Your statisticsTotals, figures for one book, the reading calendar
Your vocabularySaved words, definitions, notes and example sentences
Book textChapters, the text at a place, searching a book, following a name

What an assistant can see

A connection belongs to one reader. It sees that reader's books, places and notes, and only in the folders that reader has been given. Other readers' progress is out of its reach.

Everything it does is a lookup. It cannot move your place, edit a highlight, add a book or delete one.

  • Only applications you allowed

    No application can sign itself up. The administrator names each one, and removing it cuts every connection it has.

  • Your password stays home

    You sign in on your own server. The assistant gets a key that opens one address and nothing else on the server.

  • Keys that expire

    A key lasts an hour and is renewed in the background. If a renewal key is ever used twice, the connection is cut.

  • Book text in small amounts

    Book text tools have per-call and hourly allowances for each connection. A server restart resets the hourly allowance.

  • Book text is marked as a quotation

    Text results include a notice identifying the passage as quoted material.

  • Disconnect at any time

    Your connections are under Settings, Devices & integrations, AI assistants, each with a Disconnect button.

Questions

Does the assistant keep my books?

It reads the passages it needs to answer you. What happens to a conversation afterwards depends on the assistant's company and your settings there. The Book text permission covers chapters and passages. Highlights under Your reading and example sentences under Your vocabulary may also contain book text.

Can it spoil the ending?

A text grant lets the assistant read any chapter. It can limit an individual mention search to your saved place, but the assistant chooses which tools and cutoffs to use. A saved position can be an estimate, and a passage around it can include later text.

Which position does it use?

The one your devices last saved, from Liseur, KOReader, CrossPoint or the web reader. With an exact position it finds the paragraph; with only a percentage it estimates, and says so.

ChatGPT cannot connect

Check that the address ends in /mcp and begins with the server's configured public_url, that the server is reachable from the internet over HTTPS, and that ChatGPT is allowed on the AI assistants admin page.

It says the book text allowance is spent

Each connection may read a limited amount of book text per hour, and the message says when it renews. The administrator can raise the limit with text_bytes_per_hour.

How do I see what is connected?

Readers see their own connections under Settings, Devices & integrations, AI assistants. The administrator sees every connection on the admin page and can cut any of them.