reMarkable MCP Server (Read/Write)

reMarkable MCP Server

Unlock the full potential of your reMarkable tablet as a second brain for AI assistants. This MCP server lets Claude, VS Code Copilot, and other AI tools read, search, and traverse your entire reMarkable library — including handwritten notes via OCR.

Why remarkable-mcp?

Your reMarkable tablet is a powerful tool for thinking, note-taking, and research. But that knowledge stays trapped on the device. This MCP server changes that:

• Full library access — Browse folders, search documents, read any file
• Typed text extraction — Native support for Type Folio and typed annotations
• Handwriting OCR — Convert handwritten notes to searchable text
• PDF & EPUB support — Extract text from documents, plus your annotations
• Smart search — Find content across your entire library
• Second brain integration — Use with Obsidian, note-taking apps, or any AI workflow

Whether you're researching, writing, or developing ideas, remarkable-mcp lets you leverage everything on your reMarkable through AI.

Quick Install

🔌 USB Web Interface (Recommended)

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

[Install USB Web Mode in VS Code] [Install USB Web Mode in VS Code Insiders]

Setup:

1. Connect your reMarkable via USB
2. On your tablet: Settings → Storage → Enable "USB web interface"
3. Install via the button above

Why USB Web?

• ✅ Fast offline access over USB
• ✅ No subscription required
• ✅ Simple — just enable in Storage Settings

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

⚡ SSH Mode (Advanced)

For power users who need direct filesystem access. Faster than USB Web but requires developer mode (factory reset).

[Install SSH Mode in VS Code] [Install SSH Mode in VS Code Insiders]

Requirements: Developer mode enabled + USB connection to your reMarkable

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

☁️ Cloud Mode (Wireless)

For wireless or remote access when USB isn't available. Requires a reMarkable Connect subscription and is significantly slower than USB modes.

uvx remarkable-mcp --register YOUR_CODE

{  "inputs": [    {      "type": "promptString",      "id": "remarkable-token",      "description": "reMarkable API Token",      "password": true    },    {      "type": "promptString",      "id": "google-vision-key",      "description": "Google Vision API Key",      "password": true    }  ],  "servers": {    "remarkable": {      "command": "uvx",      "args": ["remarkable-mcp"],      "env": {        "REMARKABLE_TOKEN": "${input:remarkable-token}",        "GOOGLE_VISION_API_KEY": "${input:google-vision-key}"      }    }  }}

Connection Modes

Choose the connection method that works best for you:

📖 Detailed Setup Guides:

• USB Web Interface Setup — Recommended — simple setup, full feature support
• SSH Setup Guide — For advanced users who need filesystem access
• Cloud setup is documented in the Quick Install section above

OpenClaw Integration

remarkable-mcp works as an OpenClaw skill. Add to your openclaw.json:

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

Install from ClawHub:

clawhub install remarkable-mcp

Or copy the SKILL.md from this repository into your ~/.openclaw/skills/remarkable-mcp/ directory.

Tools

All tools return structured JSON with hints for next actions.

📖 Full Tools Documentation

Claude Code Integration

Add to your ~/.claude/settings.json:

{  "mcpServers": {    "remarkable": {      "command": "uvx",      "args": ["remarkable-mcp-rw", "--wifi"],      "env": {        "REMARKABLE_HOST": "http://YOUR_TABLET_IP"      }    }  }}

WiFi Setup

1. On your reMarkable: Settings → Storage → Enable "USB web interface"
2. Find your tablet's IP: Settings → General → About → IP address
3. Set REMARKABLE_HOST to http://YOUR_IP in the config above
4. The USB web interface works over both USB and WiFi on the same network

Smart Features

• Auto-redirect — Browsing a document path returns its content automatically
• Auto-OCR — Notebooks with no typed text automatically enable OCR
• Batch search — Search across multiple documents in one call
• Vision support — Get page images for visual context (diagrams, mockups, sketches)
• Sampling OCR — Use client's AI for OCR on images (no API key needed)
• Tag support — Filter and organize documents by tags

Example Usage

# Read a documentremarkable_read("Meeting Notes")
# Search for keywordsremarkable_read("Project Plan", grep="deadline")
# Enable OCR for handwritten notesremarkable_read("Journal", include_ocr=True)
# Browse your libraryremarkable_browse("/Work/Projects")
# Filter by tagsremarkable_browse("/", tags=["important"])remarkable_browse("/Work", tags=["project", "active"])
# Search across documentsremarkable_search("meeting", grep="action items")
# Search with tag filterremarkable_search("project", tags=["work"])
# Get recent documentsremarkable_recent(limit=10)
# Get a page image (for visual content like UI mockups or diagrams)remarkable_image("UI Mockup", page=1)
# Get SVG for editing in design toolsremarkable_image("Wireframe", output_format="svg")
# Get image with OCR text extraction (uses sampling if configured)remarkable_image("Handwritten Notes", include_ocr=True)
# Transparent background for compositingremarkable_image("Logo Sketch", background="#00000000")
# Compatibility mode: return resource URI instead of embedded resourceremarkable_image("Diagram", compatibility=True)

Resources

Documents are automatically registered as MCP resources:

📖 Full Resources Documentation

OCR for Handwriting

For handwritten content, remarkable-mcp offers several OCR backends. Choose based on your setup and requirements:

Quick Setup

Set REMARKABLE_OCR_BACKEND in your MCP config:

{  "env": {    "REMARKABLE_OCR_BACKEND": "sampling"  }}

Options: sampling, google, tesseract, auto

# Install Tesseract# macOSbrew install tesseract
# Ubuntu/Debiansudo apt install tesseract-ocr
# Windowschoco install tesseract

Default Behavior (auto)

When REMARKABLE_OCR_BACKEND=auto (default):

1. Google Vision (if GOOGLE_VISION_API_KEY is set)
2. Tesseract (fallback)

SSH vs Cloud Comparison

📖 SSH Setup Guide

Advanced Configuration

Root Path Filtering

Limit the MCP server to a specific folder on your reMarkable. All operations will be scoped to this folder:

{  "servers": {    "remarkable": {      "command": "uvx",      "args": ["remarkable-mcp", "--ssh"],      "env": {        "REMARKABLE_ROOT_PATH": "/Work",        "GOOGLE_VISION_API_KEY": "your-api-key"      }    }  }}

With this configuration:

• remarkable_browse("/") shows contents of /Work
• remarkable_browse("/Projects") shows /Work/Projects
• Documents outside /Work are not accessible

Useful for:

• Focusing on work documents during office hours
• Separating personal and professional notes
• Limiting scope for specific AI workflows

Custom Background Color

Set the default background color for image rendering:

{  "servers": {    "remarkable": {      "command": "uvx",      "args": ["remarkable-mcp", "--ssh"],      "env": {        "REMARKABLE_BACKGROUND_COLOR": "#FFFFFF"      }    }  }}

Supported formats:

• #RRGGBB — RGB hex (e.g., #FFFFFF for white)
• #RRGGBBAA — RGBA hex (e.g., #00000000 for transparent)

Default is #FBFBFB (reMarkable paper color). This affects both the remarkable_image tool and image resources.

Use Cases

Research & Writing

Use remarkable-mcp while working in an Obsidian vault or similar to transfer knowledge from your handwritten notes into structured documents. AI can read your research notes and help develop your ideas.

Daily Review

Ask your AI assistant to summarize your recent notes, find action items, or identify patterns across your journal entries.

Document Search

Find that half-remembered note by searching across your entire library — including handwritten content.

Knowledge Management

Treat your reMarkable as a second brain that AI can access. Combined with tools like Obsidian, you can build a powerful personal knowledge system.

Documentation

Development

git clone https://github.com/SamMorrowDrums/remarkable-mcp.gitcd remarkable-mcpuv sync --all-extrasuv run pytest test_server.py -v

📖 Development Guide

License

MIT

Built with rmscene, PyMuPDF, and inspiration from ddvk/rmapi.