readwise_list_documents
Retrieve and filter documents from Readwise Reader to manage saved content by ID, date, location, category, or tags for efficient organization.
Instructions
List documents from Readwise Reader with optional filtering
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Filter by specific document ID | |
| updatedAfter | No | Filter documents updated after this date (ISO 8601) | |
| addedAfter | No | Filter documents added after this date (ISO 8601). Note: This will fetch all documents first and then filter client-side. | |
| location | No | Filter by document location | |
| category | No | Filter by document category | |
| tag | No | Filter by tag name | |
| pageCursor | No | Page cursor for pagination | |
| 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. | |
| 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. | |
| 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. | |
| contentFilterKeywords | No | Filter content to include only sections containing these keywords (case-insensitive). Useful for extracting specific topics from large documents. | |
| limit | No | Maximum number of documents to return. Use this to prevent token limit issues when requesting multiple documents with content. |