ReMarkable MCP Server logo

ReMarkable MCP Server

Read, search, render, export, and manage reMarkable documents through MCP over local, cloud, USB, or SSH connections.

Install ReMarkable MCP Server

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "remarkable-mcp-server": {
      "command": "uvx",
      "args": [
        "remarkable-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

reMarkable MCP Server connects MCP clients to a reMarkable library for document browsing, text and annotation extraction, OCR, page rendering, export, and file management. It supports stdio and local Streamable HTTP, with cloud, local-directory, USB web, and SSH connection modes. Use it to retrieve information from notes and PDFs, inspect handwritten pages, or send PDFs and generated Markdown back to the tablet. Choose the transport based on whether you need offline reads, remote access, USB setup, or broader write support.

Use cases

  • Search meeting notes by name, tags, and extracted content
  • Extract typed text, highlights, and handwritten annotations from documents
  • Render annotated PDF pages or sketches for visual inspection
  • Export reMarkable notes as temporary PDF or Markdown resources
  • Upload PDFs, EPUBs, or generated Markdown documents to the tablet

Key features

  • Paginated text and annotation extraction
  • Document, tag, and content search with optional OCR
  • PNG, SVG, PDF, and Markdown rendering or export
  • Cloud, USB web, local-directory, and SSH transports
  • Upload and folder or document management in supported modes
  • Read-only interactive canvas viewer

Tools14

What ReMarkable MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~6.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

29/33 checks healthy over the last 99d

What it can do

From the 14 tools this server returned when we ran it; 14 declare their own safety hints.

Can delete or modify data · 1Handles credentials · 7Makes network requests · 3Read-only tools · 13
Unusual tool instructions. 14 tool descriptions contain text aimed at the AI model rather than at you (hidden instruction block). Read the tool descriptions before connecting.
Network at startup2 connections
Files written at startup21

Observed 2026-10-24 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · remarkable-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars265Stargazers on the source repository.
Last commit5d agoMost recent push to the default branch.
Tools exposed14Callable tools this server registers over MCP.

How ReMarkable MCP Server works

What reMarkable MCP Server does

reMarkable MCP Server exposes a reMarkable library through MCP tools. It can list folders, search document names and tags, identify recently modified files, extract source text and annotations, render pages as PNG or SVG, and export documents as PDF or Markdown. Handwriting OCR is available through Google Vision when configured, with Tesseract as the local fallback.

The server also supports selected write operations. It can upload PDF and EPUB files, convert Markdown into a paginated A4 PDF and upload it, create folders, move or rename items, and delete documents or folders. Deletion normally moves an item to Trash; permanent removal is available only through SSH and is intended for explicit permanent-delete requests.

How it works

The server can run over stdio or local Streamable HTTP. Its connection modes determine where document data comes from and which operations are available:

  • USB web reads the tablet through its USB web interface and supports reading, rendering, exporting, and uploading.
  • Local-directory mode reads the desktop application's sync cache or another xochitl-style directory without requiring a connected tablet. It is offline and read-only.
  • Cloud mode uses a registered reMarkable account token and requires a reMarkable Connect subscription. It supports remote access and document or folder management.
  • SSH mode connects directly to the tablet over a local or USB connection and provides the broadest management capabilities.

Large reads are paginated by extracted-content page. The read tool can return full text, source PDF or EPUB text, or annotations only, and can restrict the current page with a regular expression. Search can combine document-name matching, content filtering, tags, and optional OCR.

Rendered pages are returned as embedded MCP resources by default. PNG output can merge a PDF underlay with reMarkable annotations; SVG output contains the annotation layer. Clients that cannot handle embedded resources can request a resource URI instead. The canvas tool provides a read-only page viewer, with interactive navigation in clients supporting MCP Apps.

Setup and configuration

Python 3.11 or later and uv are required. The package can be launched with uvx remarkable-mcp and a mode argument such as --usb, --local-dir, or --ssh. A minimal cloud or client-neutral configuration uses the command without a mode argument.

Cloud registration starts with a one-time code from reMarkable's device connection page. Running uvx remarkable-mcp --register YOUR_CODE saves the resulting credential to ~/.rmapi; REMARKABLE_TOKEN can be used when that file is unavailable. Local-directory mode can auto-detect the desktop application's data directory or accept a custom path.

Enable the tablet's USB web interface for USB mode. SSH mode requires reMarkable developer mode, which factory-resets the tablet when enabled. The server starts with write operations enabled unless launched with --read-only or REMARKABLE_READ_ONLY=1.

Tools and capabilities

  • Browse folders, search names, filter by tags, and list recent documents.
  • Read PDF, EPUB, typed, highlighted, handwritten, and OCR-derived content.
  • Render pages as PNG or SVG and open them in a read-only canvas viewer.
  • Export complete PDFs or structured Markdown through temporary resource links.
  • Upload PDF and EPUB files, or render Markdown directly to a tablet PDF.
  • Create, move, rename, and delete documents and folders where the transport supports writes.

Limitations and notes

Local-directory mode is intentionally read-only because direct changes could corrupt the desktop application's synchronization cache. USB web mode cannot create folders or move, rename, or delete items because the tablet interface does not expose those endpoints; its upload destination is selected by the tablet and ignores the requested parent folder.

Exported resources are temporary, expire after 15 minutes, and may be evicted earlier when more than eight exports are retained. Save a linked resource if it needs to persist. Multi-document search returns at most five documents and the first approximately 8,000 characters from each result.

Older USB firmware may provide only a native PDF. In that case, annotation archives may be unavailable, SVG and explicit annotation-only rendering require an archive, and text extraction can contain source text without annotations. OCR is opt-in for relevant tools. Delete requests require client elicitation support or REMARKABLE_SKIP_CONFIRM=1 for headless operation.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about ReMarkable MCP Server

reMarkable MCP Server is an MCP server that connects AI clients to a reMarkable tablet or its synced library. Its main tools browse and search documents, read text and annotations, render pages, export files, run OCR, upload PDFs or EPUBs, and manage documents and folders where the selected connection mode permits.

Install uv, then run it with `uvx remarkable-mcp` from your MCP client's server configuration. Add `--usb`, `--local-dir`, or `--ssh` for those connection modes. Cloud mode uses the default command after registration, and Python 3.11 or later is required.

Register a one-time code with `uvx remarkable-mcp --register YOUR_CODE`, which saves a token to `~/.rmapi`. The server reads that file automatically for the same user. Set `REMARKABLE_TOKEN` when the token file is unavailable, and use a reMarkable Connect subscription.

Yes. Enable `include_ocr` on reading, searching, or image tools to process handwriting. Google Vision is used when configured; otherwise OCR runs locally with Tesseract. Annotation extraction can also return handwritten notes and highlights without OCR when the document archive is available.

Yes. It uses standard MCP over stdio or local Streamable HTTP, so it can be configured in Cursor like other compatible MCP servers. The documented setup also names Claude, VS Code Copilot, and OpenWebUI as compatible MCP clients.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewReMarkable MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/remarkable-mcp-server?style=directory)](https://allmcps.com/mcp/remarkable-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/remarkable-mcp-server"><img src="https://allmcps.com/api/badge/remarkable-mcp-server?style=directory" alt="ReMarkable MCP Server on AllMCPs" /></a>