# Readwise Reader — MCP server on mcp.ai
> Connect your Readwise Reader account and use 6 tools for bookmarks straight from your AI agent. Connect with your own API key. Save, list, organize, update, and delete documents in a Readwise Reader library.

By: mcp.ai · official
Page: https://mcp.ai/readwise_reader

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_readwise_reader?ms=1787293740000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/readwise_reader/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/readwise_reader/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/readwise_reader/skill.md
Postman collection (v2.1): https://mcp.ai/readwise_reader/postman.json

## Tools
- readwise_reader_bulk_update_documents(updates: object[]) — Partially update up to 50 Reader documents in one request and return a success or error result for every document.
- readwise_reader_delete_document(document_id: string) — Permanently delete one Reader document by its ID.
- readwise_reader_list_documents(tags?: string[], limit?: integer, category?: string, location?: string, document_id?: string, next_cursor?: string, updated_after?: string, with_html_content?: boolean, with_raw_source_url?: boolean) — List, filter, incrementally sync, or fetch a specific Reader document. Returns one page and a cursor for the next page.
- readwise_reader_list_tags(next_cursor?: string) — List tags in the connected Reader library, returning one page and a cursor for the next page.
- readwise_reader_save_document(url: string, html?: string, tags?: string[], notes?: string, title?: string, author?: string, summary?: string, category?: string, language?: string, location?: string, image_url?: string, saved_using?: string, published_date?: string, should_clean_html?: boolean) — Save a URL or supplied HTML as a document in the connected Reader library, with optional metadata, location, and tags. Returns the Reader document ID needed by update and delete tools.
- readwise_reader_update_document(seen?: boolean, tags?: string[], notes?: string, title?: string, author?: string, summary?: string, category?: string, language?: string, location?: string, image_url?: string, document_id: string, published_date?: string) — Partially update supported fields on one Reader document by ID; omitted fields remain unchanged.

## Example prompts
- "What can I do in Readwise Reader?"
- "Show me a summary of my Readwise Reader account"

## Links
Docs: https://mcp.ai/docs/mcps/readwise_reader
Website: https://mcp.ai/mcps/readwise_reader