remarkable_read
Extract text, annotations, or raw content from reMarkable documents with pagination to manage context. Search with regex and enable OCR for handwritten notes.
Instructions
Read and extract text content from a reMarkable document. Extracts content from a document with pagination to preserve context window.
Content types:
"text" (default): Full extracted text (PDF/EPUB content + annotations)
"raw": Original PDF/EPUB text only (no annotations). Works in every transport, as long as the source file is present (very large PDFs/EPUBs may not be synced to the cloud).
"annotations": Only annotations, highlights, and handwritten notes
Use pagination to read large documents without overwhelming context:
Start with page=1 (default)
Check "more" field - if true, there's more content
Use "next_page" value to get the next page
"total_pages" is the physical document count; "content_pages" is the extracted-text count used by page/more/next_page
"total_pages_known" reports whether the physical count was available. Raw PDF reads count the downloaded PDF directly. If a raw EPUB archive cannot be read, content still returns with total_pages=null.
If older USB firmware returns only a native PDF, "text" returns source text without annotations and "annotations" reports that the archive is unavailable instead of trying to parse the PDF as a zip.
Use grep to search for specific content on the current page.
OCR uses Google Vision when configured, otherwise Tesseract.
document: Document name or path (use remarkable_browse to find documents)
content_type: "text" (full), "raw" (PDF/EPUB only), "annotations" (notes only)
page: Extracted-content page number (default: 1). Physical document pages are reported separately as total_pages.
grep: Optional regex pattern to filter content (searches current page)
include_ocr: Enable handwriting OCR for annotations (default: False)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grep | No | ||
| page | No | ||
| document | Yes | ||
| include_ocr | No | ||
| content_type | No | text |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |