Hosting

hosted

Transport

Streamable HTTP

Endpoint

https://mcp2.readwise.io/mcp

Authentication

OAuth account authorization via supported client.

Requirements

• A Readwise account; available account features may depend on the user's Readwise/Reader subscription.
• An MCP client that supports remote HTTP, or a local compatibility bridge for clients without remote HTTP support.
• Browser access to authorize the Readwise account.

Setup steps

1. Add https://mcp2.readwise.io/mcp as a remote MCP server in a compatible client.
2. Start the client's connect/authenticate flow and authorize Readwise in the browser.
3. For Codex CLI, use `codex mcp add readwise --url https://mcp2.readwise.io/mcp`, then `codex mcp login readwise`.
4. For Claude Code, use `claude mcp add --transport http readwise https://mcp2.readwise.io/mcp`, then authenticate through `/mcp`.
5. Verify by asking the client to search the user's own saved highlights or Reader documents.

Crawl4AI fetched the current official Readwise tools reference, which publishes canonical identifiers and descriptions for 22 MCP tools: 6 Readwise and 16 Reader tools. This replaces the earlier conclusion that it listed labels only.

• readwise_search_highlights

  Search Readwise highlights using hybrid vector and full-text search.

  01
• readwise_list_highlights

  List highlights newest-first with optional book, tag, or date filters.

  02
• readwise_create_highlights

  Create one or more highlights, optionally attached to a book or article.

  03
• readwise_update_highlight

  Update a highlight’s text, note, location, or tags.

  04
• readwise_delete_highlight

  Delete a Readwise highlight.

  05
• readwise_get_daily_review

  Get today’s spaced-repetition Daily Review highlights.

  06
• reader_search_documents

  Search Reader documents with hybrid search across full document text.

  07
• reader_list_documents

  List Reader documents newest-first, filtered by location, category, or tag.

  08
• reader_create_document

  Save a URL or HTML/text document to Reader.

  09
• reader_get_document_details

  Fetch document metadata and full Markdown content.

  10
• reader_move_documents

  Move Reader documents among inbox, later, shortlist, archive, and feed.

  11
• reader_bulk_edit_document_metadata

  Edit metadata fields for up to 50 Reader documents.

  12
• reader_export_documents

  Start an export of Reader documents as a ZIP of Markdown files.

  13
• reader_get_export_documents_status

  Check a Reader export and retrieve its download URL when complete.

  14
• reader_list_tags

  List tags in the Reader library.

  15
• reader_add_tags_to_document

  Add tags to a Reader document.

  16
• reader_remove_tags_from_document

  Remove tags from a Reader document.

  17
• reader_get_document_highlights

  Get all highlights for a Reader document.

  18
• reader_create_highlight

  Create a highlight on a document by specifying the exact text.

  19
• reader_add_tags_to_highlight

  Add tags to a Reader document highlight.

  20
• reader_remove_tags_from_highlight

  Remove tags from a Reader document highlight.

  21
• reader_set_highlight_notes

  Set the note attached to a Reader document highlight.

  22

• The current server supersedes the older Readwise-only server and covers Reader plus Highlights. Public setup docs describe tool actions but use display labels instead of exact MCP identifiers.

• official publisher documentation

  Current docs detail 15 Reader and 6 Readwise actions, but reviewed official tool reference uses action labels rather than stable tool identifiers.

• official legacy implementation

  Legacy repository registers search_readwise_highlights, but its README says deprecated and directs users to the hosted server; excluded from current inventory.

• official documentation

  Current publisher or maintainer documentation reviewed 2026-10-28T19:00:00.000Z.

• official vendor documentation

  Official docs enumerate 16 Reader actions and 6 Highlights actions (22 described capabilities total); they do not publish canonical MCP tool identifiers.

Documentation checked 2026-10-29T00:00:00Z. Connection has not been runtime tested.