The Official Readwise MCP Server

All of your Readwise highlights. All of your Reader documents.
Accessible to your AI. Works with Claude, ChatGPT, and more.

Setup Instructions

Click your app to see how to connect.

Other Apps

Add the URL directly in any MCP-compatible app as a remote server:

https://mcp2.readwise.io/mcp

If your AI app doesn't support remote HTTP MCP servers, you can try adding it as a stdio server instead:

npx -y mcp-remote https://mcp2.readwise.io/mcp

Example Use Cases

Things you can ask your AI assistant to do with your Readwise and Reader data. Click any prompt to copy it.

Search across everything you've read Search my highlights and documents for anything related to "learning" and tell me what I've read and highlighted about it.

Triage your inbox Triage my Reader inbox. Show me the 10 newest items in a table with links, tell me which are worth reading and why, and offer to move the rest to my archive.

Daily or weekly digest Give me a digest of everything saved to my library in the last week. Cluster the items by theme in a table with links and summarize what's interesting.

Quiz yourself Pick one of my recently archived articles and quiz me on it with multiple-choice questions. Grade my answers and tell me what I missed.

Get reading recommendations Look at my recent highlights and reading history, then recommend 3 items from my library I should read next. I have about 20 minutes.

Organize your library Help me organize my Reader inbox. For each item, suggest tags and whether to shortlist, save for later, or archive it. Ask me before making changes.

Surprise me Read a large sample of my Readwise highlights, documents, notes, and tags. Then tell me something surprising that I don't know about myself.

Browse more pre-built skills on GitHub →

Supported Tools

The full set of tools your AI can use once connected. Tool names are stable, so you can reference them directly in prompts.

Tool	Description
Readwise highlights
readwise_search_highlights	Search your Readwise highlights with hybrid (vector + full-text) search.
readwise_list_highlights	List highlights newest-first with optional filters (book, tag, date range, etc.).
readwise_create_highlights	Create one or more highlights, optionally attached to a book or article.
readwise_update_highlight	Update a highlight's text, note, location, or tags.
readwise_delete_highlight	Delete a Readwise highlight.
readwise_get_daily_review	Get today's daily review of highlights selected by spaced repetition.
Reader documents
reader_search_documents	Search your Reader library with hybrid search across full document text.
reader_list_documents	List Reader documents newest-first, filtered by location, category, or tag.
reader_create_document	Save a new URL or HTML/text document to Reader.
reader_get_document_details	Fetch a document's metadata and full Markdown content.
reader_move_documents	Move documents between locations (inbox, later, shortlist, archive, feed).
reader_bulk_edit_document_metadata	Edit metadata fields (title, author, category, etc.) for up to 50 documents at a time.
reader_export_documents	Trigger an export of all Reader documents as a ZIP of Markdown files.
reader_get_export_documents_status	Poll a Reader export for status and a download URL once complete.
Reader tags
reader_list_tags	List all tags in your Reader library.
reader_add_tags_to_document	Add one or more tags to a Reader document.
reader_remove_tags_from_document	Remove tags from a Reader document.
Reader highlights
reader_get_document_highlights	Get all highlights for a Reader document.
reader_create_highlight	Create a new highlight on a document by specifying the exact text.
reader_add_tags_to_highlight	Add tags to a Reader document highlight.
reader_remove_tags_from_highlight	Remove tags from a Reader document highlight.
reader_set_highlight_notes	Set the note attached to a Reader document highlight.

Looking for the CLI?

Use Claude Code, Codex, or another terminal agent? The Readwise CLI gives your agent direct access — no MCP setup needed.

Set up Readwise CLI →