readwise_save_documentLABSCO SUMMARY
Your reading queue as something the assistant can file from and read from.
Saving is the easy half. The half that changes how you work is listing with updatedAfter and full content, which turns an archive into a corpus you can ask questions of. The token is a personal access token, so its reach is the whole Reader account.
What it is
A TypeScript server over the Readwise Reader API. It saves documents, lists them with filters and pagination, and updates them in place. HTML content is converted to clean text through r.jina.ai on the way back, so a saved article arrives readable rather than as markup.
What you get
- A URL, or raw HTML, saved to Reader with tags, a location among new, later, shortlist, archive and feed, and a category among article, book, tweet, pdf, email, youtube and podcast (readwise_save_document)
- Documents listed with filtering on location, category and tags (readwise_list_documents)
- Large collections paged through with pageCursor, and narrowed to what changed since a point in time with updatedAfter
- Full document content requested alongside metadata through withFullContent and withHtmlContent
- Documents updated in place, including location and tags (readwise_update_document)
- HTML converted to clean text automatically, so what comes back is fit for a model to read
Requirements
Node with a local build, npm install then npm run build, and a Readwise access token in the server's environment, taken from readwise.io/access_token.
Setup effort
Build from source — git clone https://github.com/edricgsh/Readwise-Reader-MCP.git
USE CASES
01
Saving something you just found, into the right place
Send the URL with its tags, a location such as shortlist or later, and a category, so it lands filed instead of arriving in an inbox you will triage another day.
02
Asking questions across what you have read
List with a filter and full content turned on, and the article text comes back as clean text rather than markup, which is what makes summarising or comparing several pieces possible at all.
03
Catching up on what changed since last time
Pass updatedAfter and page through with the cursor, so a nightly digest reads only what is new instead of walking the whole library again.
04
Clearing out the shortlist
List what is sitting in one location, then update each document's location and tags in place, which is how a backlog gets archived without opening the app.
6 tools
Listed in project docs. Your client may show a different list.
readwise_list_documentsreadwise_update_documentreadwise_delete_documentreadwise_list_tagsreadwise_topic_searchBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
READWISE_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/edricgsh/Readwise-Reader-MCP.git
cd Readwise-Reader-MCP
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"readwise-reader": {
"command": "node",
"args": [
"<YOUR_PATH_TO_READWISE_READER_MCP>/dist/index.js"
],
"env": {
"READWISE_TOKEN": "<YOUR_READWISE_TOKEN>"
}
}
}
}
