remarkable_read
Read and extract text, annotations, and handwriting from reMarkable documents. Supports pagination and search for large files.
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). SSH mode only.
"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
Use grep to search for specific content on the current page.
When REMARKABLE_OCR_BACKEND=sampling is set and the client supports sampling, OCR will use the client's LLM for handwriting recognition (no API keys needed).
document: Document name or path (use remarkable_browse to find documents)
content_type: "text" (full), "raw" (PDF/EPUB only), "annotations" (notes only)
page: Page number (default: 1). For notebooks, this is the notebook page.
grep: Optional regex pattern to filter content (searches current page)
include_ocr: Enable handwriting OCR for annotations (default: False)
remarkable_read("Meeting Notes") # Get first page of text
remarkable_read("Book.pdf", content_type="raw") # Get raw PDF text
remarkable_read("Notes", content_type="annotations") # Only annotations
remarkable_read("Report", page=2) # Get second page
remarkable_read("Manual", grep="installation") # Search for keyword
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"document": "<document>"
},
"name": "remarkable_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| document | Yes | ||
| content_type | No | text | |
| page | No | ||
| grep | No | ||
| include_ocr | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |