reMarkable MCP Server

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/sammorrowdrums-remarkable

About

Use cases: file-management, document-processing, note-taking

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

4 read · 3 write · 1 delete · 8 not yet classified

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (16)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• remarkable_author

  <usecase>Author native reMarkable ink and notebooks. ONE compound write primitive with three methods: "draw" appends pen/highlighter strokes to a page, "add_page" appends a blank drawable page to a notebook, and "create_document" creates a new notebook (optionally seeded with typed text). This is the single tool behind the interactive canvas (Save → draw, ＋Page → add_page, new notebook → create_document) AND model-driven markup (highlighting, underlining, marking) — the model composes the strokes.</usecase> <instructions> …

• remarkable_browse

  <usecase>Browse your reMarkable library or search for documents.</usecase> <instructions> Three modes: 1. Browse mode (default): List contents of a folder - Use path="/" for root folder - Use path="/FolderName" to navigate into folders 2. Search mode: Find documents by name - Set query="search term" to search across all documents 3. Filter by tags: Find documents with specific tags - Set tags=["tag1", "tag2"] to filter by tags - Works in both browse and search modes Results include document names, types, modification dates, and tags. Note: If REMARKABLE_ROOT_PATH is configured…

• remarkable_canvas

  <usecase>Open a reMarkable page in an interactive canvas viewer.</usecase> <instructions> Renders a notebook or document page and, in clients that support MCP Apps interactive UI, opens a canvas viewer that lets the user page through the document. This is the entry point for the interactive viewer. The canvas is currently a read-only viewer (render + page navigation). For plain image extraction without the interactive surface, use remarkable_image instead. Clients that do not support MCP Apps still get the rendered page back as an embedded PNG image, so this tool is useful everywhere; it jus…

• remarkable_delete

  <usecase>Delete a document or folder on the reMarkable tablet.</usecase> <instructions> DESTRUCTIVE operation. By default the item is moved to the tablet's Trash and remains recoverable. In SSH mode only, permanent=True removes the resolved UUID and all sidecar files instead; use that only when the user explicitly asked for permanent deletion. Works in cloud and SSH modes (default; --read-only disables). Not available over the USB web interface. If the client supports elicitation, this tool asks the user to confirm before deleting. If the client cannot show a confirmation prompt, the delete …

• remarkable_export

  <usecase>Export one reMarkable document as a reusable PDF or Markdown file.</usecase> <instructions> Exports a single document without modifying the tablet or its library. The generated file is written to a server-managed temporary directory and returned as an MCP ResourceLink. The tool response stays small: it never embeds the PDF/Markdown as base64 and never writes to an arbitrary host path. The resource expires after 15 minutes and may be evicted earlier when more than eight exports are retained. Fetch and save the linked resource for durable use. PDF behavior: - `pdf_mode="merged"` (defa…

• remarkable_image

  <usecase>Get an image of a specific page from a reMarkable document.</usecase> <instructions> Renders a notebook or document page as an image (PNG or SVG). This is useful for: - Viewing hand-drawn diagrams, sketches, or UI mockups - Getting visual context that text extraction might miss - Implementing designs based on hand-drawn wireframes - SVG format for scalable vector graphics that can be edited ## Merged PDF + Annotation Rendering PNG pages backed by an imported PDF automatically composite the PDF page with its reMarkable annotations. Set render_merged=False for an annotation-only rende…

• remarkable_markdown_to_pdf

  <usecase>Render Markdown text as a PDF and upload it to the reMarkable tablet.</usecase> <instructions> Use this when the user wants notes, reports, summaries, or other Markdown content written back to the tablet without first creating a local file. Headings, lists, tables, links, blockquotes, and code blocks are rendered into a paginated A4 PDF. Raw HTML is escaped and image assets are omitted so rendering never reads local files or fetches remote content. Works in all three transports: - Cloud: sync upload with parent_folder and document_name - SSH: filesystem upload with parent_folder and …

• remarkable_mkdir

  <usecase>Create a new folder on the reMarkable tablet.</usecase> <instructions> Creates a folder in the tablet's document hierarchy. In SSH mode the folder appears after xochitl restarts; in cloud mode it syncs to all your devices. Works in cloud and SSH modes (default; --read-only disables). Not available over the USB web interface (the firmware exposes no folder-create endpoint). </instructions> <parameters> - folder_name: Name of the new folder - parent: Parent folder path (default: root "/") - defer_restart: SSH only. Skip the xochitl restart so a batch of writes can refresh once via re…

• remarkable_move

  <usecase>Move a document or folder to a different location.</usecase> <instructions> Moves a document or folder by updating its parent reference in the metadata. Find the document name with remarkable_browse() first. Works in cloud and SSH modes (default; --read-only disables). Not available over the USB web interface. </instructions> <parameters> - document: Name or path of the document/folder to move - dest_folder: Destination folder path (use "/" for root) - defer_restart: SSH only. Skip the xochitl restart so a batch of writes can refresh once via remarkable_refresh() instead of once …

• remarkable_read

  <usecase>Read and extract text content from a reMarkable document.</usecase> <instructions> 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 (def…

• remarkable_recent

  <usecase>Get your most recently modified documents.</usecase> <instructions> Returns documents sorted by modification date (newest first). Optionally includes a text preview of each document's content. Use this to quickly find what you were working on recently. Note: If REMARKABLE_ROOT_PATH is configured, only documents within that folder are included. </instructions> <parameters> - limit: Maximum documents to return (default: 10, max: 50 without preview, 10 with preview) - include_preview: Include first ~200 chars of text content (default: False) </parameters> <examples> - remarkable_recent…

• remarkable_refresh

  <usecase>Restart xochitl once to apply writes made with defer_restart=True (or with REMARKABLE_DEFER_RESTART set).</usecase> <instructions> SSH only. Each write normally restarts xochitl so the change becomes visible, but every restart forces a full document-store rescan that briefly destabilises the SSH link. For a batch of writes, pass defer_restart=True to each one and then call this tool ONCE at the end: it pays the restart cost a single time instead of once per write, eliminating the per-write race and the redundant rescans. Once this server process has confirmed a clean refresh state, c…

• remarkable_rename

  <usecase>Rename a document or folder on the reMarkable tablet.</usecase> <instructions> Changes the display name of a document or folder by updating its metadata. Find the document name with remarkable_browse() first. Works in cloud and SSH modes (default; --read-only disables). Not available over the USB web interface. </instructions> <parameters> - document: Current name or path of the document/folder - new_name: New display name - defer_restart: SSH only. Skip the xochitl restart so a batch of writes can refresh once via remarkable_refresh() instead of once per write. Sets "refresh_pen…

• remarkable_search

  <usecase>Search across multiple documents and return matching content.</usecase> <instructions> Searches document names for the query, then optionally searches content with grep. Can filter by tags to narrow results. Returns summaries from multiple documents in a single call. This is efficient for finding information across your library without making many individual tool calls. Limits: - Max 5 documents per search (to keep response size manageable) - Returns first page (~8000 chars) of each matching document - Use grep to filter to relevant sections </instructions> <parameters> - query: Sea…

• remarkable_status

  <usecase>Check connection status, active transport, and write capabilities.</usecase> <instructions> Returns authentication status, the active transport (cloud, local-dir, ssh, or usb-web), the document count, and a capability matrix describing what each transport can do. Use this to verify your connection, choose a transport, or troubleshoot. Capability notes: - Export is available in every transport and creates only a bounded temporary local resource; it never modifies the tablet. - Cloud (default): full read/render/export/upload/mkdir/move/rename/delete — no device needed, works from a…

Signals

Stars

252

Forks

57

Open issues

12

Contributors

10

Weekly downloads

646

Last commit

Oct 2, 2026 (26 days ago)

Last release

Aug 17, 2026 (2 months ago)

Last package publish

Aug 17, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.SamMorrowDrums/remarkable

Version

2.1.0

Auth

API key

Packages

pypi remarkable-mcp

License

MIT

Repository

github.com/SamMorrowDrums/remarkable-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql