reMarkable MCP Server

Access a reMarkable library from MCP clients such as Claude, VS Code Copilot, OpenWebUI, and other compatible tools.

Features

• Browse folders and recent documents.
• Search names, tags, and extracted text.
• Read typed text, PDF and EPUB text, highlights, and annotations.
• Render notebooks and annotated PDFs as PNG or SVG.
• Export one document as a complete PDF or sectioned Markdown resource.
• Run handwriting OCR through Google Vision or Tesseract.
• Upload files and manage folders in supported transports.
• Render Markdown as PDF and upload it to the tablet.
• Open an interactive canvas in clients that support MCP Apps.
• Serve MCP over stdio or local Streamable HTTP.
• Serve MCP 2026-07-28 and every earlier SDK-supported revision from one stable SDK 2.x MCPServer.

Quick Install

Prerequisite: install uv

The commands below use uvx, which is included with uv. Page images are rasterized with PyMuPDF; no system Cairo, browser, or graphics runtime needs to be installed on macOS, Linux, or Windows.

macOS and Linux

Use the official standalone installer:

curl -LsSf https://astral.sh/uv/install.sh | sh

Or install with Homebrew:

brew install uv

Windows

Use the official standalone installer from PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Or install with WinGet:

winget install --id=astral-sh.uv -e

Choose a connection

Start with the first mode that fits your setup.

USB Web Interface

Connect via USB and enable the web interface in your tablet's Storage Settings.

1. Connect your reMarkable via USB
2. On your tablet, open Settings > Storage and enable USB web interface
3. Install via the button above

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--usb"],
      "env": {
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

Local Directory Mode

Read the official reMarkable desktop app's sync folder from disk. This mode is offline and read-only. The desktop app controls synchronization.

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--local-dir"]
    }
  }
}

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--local-dir", "/path/to/xochitl-data"]
    }
  }
}

Cloud Mode

Cloud mode works without a device connection and requires a reMarkable Connect subscription.

It fetches metadata in parallel and caches content-addressed blobs on disk. See Cloud performance and caching for configuration.

uvx remarkable-mcp --register YOUR_CODE

{
  "command": "uvx",
  "args": ["remarkable-mcp"]
}

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp"]
    }
  }
}

{
  "mcpServers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp"]
    }
  }
}

SSH Mode

SSH provides direct filesystem access and native notebook authoring. It requires developer mode, which factory-resets the tablet when enabled. Use this mode only when USB web, local directory, or cloud mode does not provide the operation you need.

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--ssh"]
    }
  }
}

See the SSH setup guide for authentication and device setup.

Connection Modes

All modes support reading, rendering, and single-document export. Cloud and SSH support full library management. USB web supports upload but does not accept a destination folder. Local directory mode is read-only.

¹ Folder ops = create folder / move / rename / delete. Upload and folder ops are enabled by default; pass --read-only to expose a read-only server. Deletes move items to the trash and prompt for confirmation when your client supports elicitation, and are refused without it unless REMARKABLE_SKIP_CONFIRM=1 is set.