| reader_list_documentsA | List documents from your Readwise Reader library.
Args:
id: Get a single document by ID (returns only that document)
location: Filter by folder location (new, later, shortlist, archive, feed)
category: Filter by category (article, email, rss, highlight, note, pdf, epub, tweet, video)
tag: Filter by tag keys (pass empty list [] for untagged documents)
updatedAfter: Filter by update time (ISO 8601 format, e.g., 2024-01-01T00:00:00Z)
limit: Number of results to return (1-100, default: 100)
withContent: Include full HTML content in response (default: false)
pageCursor: Pagination cursor for next page
Returns:
ListDocumentResponse with count, results, and nextPageCursor
|
| reader_create_documentA | Save a new document (URL) to your Readwise Reader library.
Args:
url: (Required) URL to save. Can be a placeholder if no URL is available (e.g., https://yourapp.com#document1)
html: Provide the document's content as valid HTML (Readwise will not scrape the URL)
should_clean_html: Auto-clean HTML and parse metadata when html is provided (default: false)
title: Override the detected title
author: Override the detected author
summary: Override the detected summary
publishedDate: Publication date (ISO 8601 format)
imageUrl: Cover image URL
location: Where to save the document (new, later, archive, feed; default: new)
category: Override the detected category (article, email, rss, highlight, note, pdf, epub, tweet, video)
saved_using: Source identifier for the document (e.g., "MyApp")
tags: List of tags to apply
notes: Personal notes about the document
Returns:
CreateDocumentResponse with id, url, title, and status
|
| reader_update_documentA | Update a document in your Readwise Reader library.
Args:
id: (Required) Document ID to update
title: New title
author: New author
summary: New summary
published_date: Publication date (ISO 8601 format)
image_url: Cover image URL
location: New location (new, later, shortlist, archive, feed)
category: New category (article, email, rss, highlight, note, pdf, epub, tweet, video)
tags: Replace existing tags (note: this replaces, not appends)
notes: Update personal notes (empty string clears notes)
seen: Mark as seen (true) or unseen (false)
Returns:
UpdateDocumentResponse with id, updated status, and document
|
| reader_bulk_update_documentsA | Bulk update multiple documents (max 50 per request).
Args:
updates: (Required) Array of update objects. Each object must have:
- id: (Required) Document ID to update
- title: (Optional) New title
- author: (Optional) New author
- summary: (Optional) New summary
- published_date: (Optional) Publication date (ISO 8601)
- image_url: (Optional) Cover image URL
- location: (Optional) New location (new, later, shortlist, archive, feed)
- category: (Optional) New category (article, email, rss, highlight, note, pdf, epub, tweet, video)
- tags: (Optional) Replace tags
- notes: (Optional) Update notes
- seen: (Optional) Mark as seen/unseen
Returns:
BulkUpdateResponse with count and results
|
| reader_delete_documentA | Delete one or more documents from your Readwise Reader library.
Args:
ids: (Required) Array of document IDs to delete (at least one)
Returns:
DeleteDocumentResponse with deleted count and ids
|
| reader_list_tagsA | List all tags from your Readwise Reader library.
Returns:
ListTagsResponse with count and results
|
| reader_auth_checkA | Verify authentication with the Readwise Reader API.
Returns:
AuthCheckResponse with authenticated status
Raises:
ValueError: If authentication fails (401) or rate limited (429)
|
