The Readwise MCP connector routes your AI agent's tool calls to Readwise's own MCP server through Scalekit. Each user signs in to Readwise once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 22 tools.
- Tools
- 22
- What they doRead · write · destructive
- 9 · 6 · 79 read6 write7 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Readwise MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Readwise MCP connection
In AgentKit > Connections, create a Readwise MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Readwise MCP server connections use your own OAuth app. Register one with Readwise MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Readwise MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'readwisemcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Readwise MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'readwisemcp_reader_list_documents',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "readwisemcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Readwise MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="readwisemcp_reader_list_documents",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolreadwisemcp_reader_get_document_detailsGet Reader document details, including Markdown contentRead-onlyGet Reader document details
Get Reader document details, including Markdown content
Inputs
document_idstringrequired- The ID of the document to get details for
readwisemcp_reader_get_document_highlightsGet highlights for a Reader documentRead-onlyGet Reader document highlights
Get highlights for a Reader document
Inputs
document_idstringrequired- The ID of the document to get highlights for
readwisemcp_reader_get_export_documents_statusCheck the status of a previously triggered Reader document export.Read-onlyCheck Reader export status
Check the status of a previously triggered Reader document export. Returns `status` ('processing' or 'completed'), progress counts, and a `download_url` when the export is complete.
Inputs
export_idstringrequired- The export ID returned by `reader_export_documents`.
readwisemcp_reader_list_documentsList Reader documents.Read-onlyList Reader documents
List Reader documents. Documents are returned from the most recently added to the least recently added. This tool can be used to find N newest documents. Tip: unseen documents have first_opened_at=null, seen documents have a non-null first_opened_at. You can mark documents as seen with reader_bulk_edit_document_metadata(documents=[{document_id: ..., seen: true}]). Tip: for videos (e.g. YouTube) and podcasts, word_count and reading_time are null; use listening_time (duration formatted like reading_time, e.g. '13 mins') instead.
Inputs
categorystring- Filter by document categoryone of
articleemailrsshighlightnotepdfepubtweetvideopodcastaudiobook idstring- The document's unique ID. Using this parameter will return just one document, if found.
limitinteger- The maximum number of documents to returndefault
10 locationstring- Filter by document location. 'new' = inbox (where newly saved documents go), 'later' = saved for later, 'shortlist' = shortlisted, 'archive' = archived, 'feed' = RSS feed items (only use when user explicitly asks about feed/RSS). When user says 'inbox', use 'new'.one of
newlatershortlistarchivefeed page_cursorstring- A string returned by a previous request to get the next page of documents
response_fieldsarray- Optional fields to include in each document result. The 'id' field is always included. If not specified, all fields except the full-body 'content' and 'html_content' are included, since a single document body can be 100k+ characters. Request 'content'/'html_content' explicitly here (or use reader_get_document_details) only when you need the full text of the listed documents.
seenboolean- Filter by seen status. True = only documents that have been opened, False = only unopened documents.
tagarray- Filter by tag(s). Pass up to 5 tags to find documents having all the tags listed. Pass empty string in the list to find untagged documents.
updated_afterstring- Fetch only documents updated after this date (ISO 8601 datetime)
readwisemcp_reader_search_documentsSearch Reader documents using hybrid searchRead-onlySearch Reader documents
Search Reader documents using hybrid search
Inputs
querystringrequired- Search in document content
author_searchstring- Search document author
category_inarray- Restrict search to specific categories
document_idstring- Restrict search to a specific document
limitinteger- The maximum number of documents to returndefault
20 location_inarray- Restrict search to specific locations. Values: 'new' (inbox), 'later', 'shortlist', 'archive'. When user says 'inbox', use ['new']. This tool does not search the feed, only locations in the user's library.Defaults to ["new", "later", "shortlist", "archive"].
note_searchstring- Search in document notes
published_datestring- Search by published date (ISO 8601 date)
published_date_gtstring- Search by published date greater than (ISO 8601 date)
published_date_gtestring- Search by published date greater than or equal to (ISO 8601 date)
published_date_ltstring- Search by published date less than (ISO 8601 date)
published_date_ltestring- Search by published date less than or equal to (ISO 8601 date)
source_searchstring- Search in document source
summary_searchstring- Search in document summary
tags_inarray- Restrict search to specific tags
tags_searchstring- Search in document tags
title_searchstring- Search in document title
url_searchstring- Search in document URL
readwisemcp_readwise_get_daily_reviewGet the user's daily review of highlights.Read-onlyGet Readwise daily review
Get the user's daily review of highlights. Returns today's review with all highlights selected for review by the spaced repetition algorithm. Includes the review URL where the user can complete the review interactively.
Inputs
This tool takes no inputs.
readwisemcp_readwise_list_highlightsList Readwise highlights with optional filters.Read-onlyList Readwise highlights
List Readwise highlights with optional filters. Highlights are returned from the most recently added to the least recently added. This tool can be used to find N newest highlights. Use `response_fields` to control which fields are returned — omit it for the default set (all base highlight fields, no book detail), or pass a subset (and optionally any book_* field) to minimize the response and include parent-book metadata.
Inputs
book_idinteger- Filter by book ID
highlighted_at_gtstring- Filter highlights created after this datetime (ISO 8601)
highlighted_at_ltstring- Filter highlights created before this datetime (ISO 8601)
pageinteger- Page number for pagination
page_sizeinteger- Number of highlights per pagedefault
100 response_fieldsarray- Fields to include on each highlight result. Use this to reduce response size and save tokens. The 'id' field is always included. If not specified, every base highlight field is returned (including 'book_id') but no book-detail fields (book_title, book_author, ...) are fetched. Requesting any book-detail field enriches each highlight with its parent book's metadata in the same request.
updated_gtstring- Filter highlights updated after this datetime (ISO 8601)
updated_ltstring- Filter highlights updated before this datetime (ISO 8601)
readwisemcp_readwise_search_highlightsSearch Readwise highlightsRead-onlySearch Readwise highlights
Search Readwise highlights
Inputs
vector_search_termstringrequired- Searches document content using vector search
full_text_queriesarray- Optional field targeted full text search queries
limitinteger- The maximum number of highlights to returndefault
30
readwisemcp_reader_create_documentSave a new document to ReaderWriteSave document to Reader
Save a new document to Reader
Inputs
authorstring- The document's author, overwrites the original author
categorystring- The document category. Default is guessed based on the URL, usually article.one of
articleemailrsspdfepubtweetvideopodcastaudiobook htmlstring- The content of the document in HTML format. Use `markdown` instead if you have Markdown content. If not provided, Reader will try to scrape the URL.
image_urlstring- An image URL to use as cover image
languagestring- Language code for the document. When omitted, Reader will auto-detect it.
markdownstring- The content of the document in Markdown format. Use `html` instead if you have HTML content.
notesstring- A top-level note for the document
published_datestring- When the document was published in ISO 8601 format
summarystring- Summary of the document
tagsarray- A list of tags to apply to the document
titlestring- The document's title, overwrites the original title. Should be provided when `html` is provided.
urlstring- The unique URL of the document. If you don't have one, you can provide a made up value such as https://yourapp.com#document1
readwisemcp_reader_create_highlightCreate a new highlight on a document by specifying the exact text to highlightWriteCreate Reader highlight
Create a new highlight on a document by specifying the exact text to highlight
Inputs
document_idstringrequired- The ID of the document to highlight
html_contentstringrequired- The passage to highlight, copied verbatim from the document text. Whitespace may differ, but every other character must match -- do NOT reformat, paraphrase, trim or change any characters.
notestring- Optional note to attach to the highlight
tagsarray- Optional tag names to apply to the highlight
readwisemcp_reader_export_documentsExport all Reader documents as a ZIP file containing Markdown files with YAML frontmatter.WriteExport Reader documents
Export all Reader documents as a ZIP file containing Markdown files with YAML frontmatter. This tool triggers the export and returns immediately with an `export_id`. Use `reader_get_export_documents_status` to poll for completion and get the download URL. The response includes `last_updated` which can be saved and passed as `since_updated` in a future export to only include documents updated since this export.
Inputs
since_updatedstring- Optional timestamp for delta exports. Only documents updated after this timestamp will be included. Use `last_updated` from a previous export.
readwisemcp_readwise_create_highlightsCreate one or more highlights in Readwise.WriteCreate Readwise highlights
Create one or more highlights in Readwise. When creating a Reader document highlight, use reader_create_highlight instead. Each highlight can be from the same or multiple books/articles. If you don't include a title, we'll put the highlight in a generic 'Quotes' book. If you don't include an author we'll keep it blank or just use the URL domain (if a source_url was provided). We de-dupe highlights by title/author/text/source_url. We'll put the created highlights in a book, based on the title/author/source_url combination.
Inputs
highlightsarrayrequired- List of highlights to create
readwisemcp_reader_bulk_edit_document_metadataEdit metadata fields such as title, author, summary, language, seen status, location, category, tags, and notes for one or more Reader documents in a single call.DestructiveBulk edit Reader document metadata
Edit metadata fields such as title, author, summary, language, seen status, location, category, tags, and notes for one or more Reader documents in a single call. Max 50 documents per call. Bulk update calls are rate-limited to 20 per minute (shared with reader_move_documents) — batch documents into fewer calls instead of calling once per document. Check the result success flags to confirm all documents have been edited successfully.
Inputs
documentsarrayrequired- List of documents to edit, each with a document_id and the metadata fields to update
readwisemcp_reader_move_documentsMove one or more Reader documents to a different location (e.g.DestructiveMove Reader documents
Move one or more Reader documents to a different location (e.g. archive, later, shortlist). Max 50 documents per call. Bulk update calls are rate-limited to 20 per minute (shared with reader_bulk_edit_document_metadata) — batch document IDs into fewer calls instead of calling once per document. Check the result success flags to confirm all documents have been moved successfully.
Inputs
document_idsarrayrequired- The IDs of the documents to move
locationstringrequired- The new location for the documentsone of
newlatershortlistarchivefeed
readwisemcp_reader_set_highlight_notesSet notes for a Reader document highlightDestructiveSet notes on Reader highlight
Set notes for a Reader document highlight
Inputs
document_idstringrequired- The ID of the document containing the highlight
highlight_document_idstringrequired- The ID of the highlight document to set notes for
notesstring- The notes to set for the highlight. Pass null to clear the notes.
readwisemcp_readwise_delete_highlightDelete a Readwise highlightDestructiveDelete Readwise highlight
Delete a Readwise highlight
Inputs
highlight_idintegerrequired- The ID of the highlight to delete
readwisemcp_readwise_update_highlightUpdate a Readwise highlight.DestructiveUpdate Readwise highlight
Update a Readwise highlight. Supports adding and removing tags in a single call.
Inputs
highlight_idintegerrequired- The ID of the highlight to update
add_tagsarray- Tag names to add to the highlight
colorstring- New color for the highlightone of
yellowbluepinkorangegreenpurple locationinteger- New location for the highlight
notestring- New note for the highlight
remove_tagsarray- Tag names to remove from the highlight (matched by name)
textstring- New text for the highlight
urlstring- New URL for the highlight
No tools match.