readwise_list_documents
Retrieve and filter documents from Readwise Reader by ID, date, category, location, or tag. Supports pagination, content extraction, and keyword filtering for efficient document management.
Instructions
List documents from Readwise Reader with optional filtering
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| addedAfter | No | Filter documents added after this date (ISO 8601). Note: This will fetch all documents first and then filter client-side. | |
| category | No | Filter by document category | |
| contentFilterKeywords | No | Filter content to include only sections containing these keywords (case-insensitive). Useful for extracting specific topics from large documents. | |
| contentMaxLength | No | Maximum length of content to include per document (in characters). Default: 50000. Use with withFullContent=true to prevent token limit issues. | |
| contentStartOffset | No | Character offset to start content extraction from. Use with contentMaxLength for pagination through large documents. Default: 0. | |
| id | No | Filter by specific document ID | |
| limit | No | Maximum number of documents to return. Use this to prevent token limit issues when requesting multiple documents with content. | |
| location | No | Filter by document location | |
| pageCursor | No | Page cursor for pagination | |
| tag | No | Filter by tag name | |
| updatedAfter | No | Filter documents updated after this date (ISO 8601) | |
| withFullContent | No | ⚠️ PERFORMANCE WARNING: Include full converted text content in the response. This significantly slows down the API as it fetches and processes each document's content. Only use when explicitly requested by the user or when document content is specifically needed for analysis/reading. Default: false for performance. | |
| withHtmlContent | No | ⚠️ PERFORMANCE WARNING: Include HTML content in the response. This significantly slows down the API. Only use when explicitly requested by the user or when raw HTML is specifically needed for the task. |