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.

%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22remarkable-mcp%22%2C%22--usb%22%5D%2C%22env%22%3A%7B%22GOOGLE_VISION_API_KEY%22%3A%22%24%7Binput%3Agoogle_vision_api_key%7D%22%7D%7D) %22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22remarkable-mcp%22%2C%22--usb%22%5D%2C%22env%22%3A%7B%22GOOGLE_VISION_API_KEY%22%3A%22%24%7Binput%3Agoogle_vision_api_key%7D%22%7D%7D&quality=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

📋 Manual USB Web Configuration

Add to .vscode/mcp.json:

{

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

Troubleshooting:

• Make sure your reMarkable is connected via USB and unlocked
• Verify USB web interface is enabled in Settings → Storage
• The tablet should be accessible at http://10.11.99.1

---

⚡ SSH Mode (Advanced)

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

%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22remarkable-mcp%22%2C%22--ssh%22%5D%2C%22env%22%3A%7B%22GOOGLE_VISION_API_KEY%22%3A%22%24%7Binput%3Agoogle_vision_api_key%7D%22%7D%7D) %22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22remarkable-mcp%22%2C%22--ssh%22%5D%2C%22env%22%3A%7B%22GOOGLE_VISION_API_KEY%22%3A%22%24%7Binput%3Agoogle_vision_api_key%7D%22%7D%7D&quality=insiders)

Requirements: Developer mode enabled + USB connection to your reMarkable

📋 Manual SSH Configuration

Add to .vscode/mcp.json:

{

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

See SSH Setup Guide for detailed instructions.

---

☁️ 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.

📋 Cloud Mode Setup

1. Get a One-Time Code

Go to my.remarkable.com/device/desktop/connect and generate a code.

2. Convert to Token

uvx remarkable-mcp --register YOUR_CODE

3. Install

%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22remarkable-mcp%22%5D%2C%22env%22%3A%7B%22REMARKABLE_TOKEN%22%3A%22%24%7Binput%3Atoken%7D%22%2C%22GOOGLE_VISION_API_KEY%22%3A%22%24%7Binput%3Agoogle_vision_api_key%7D%22%7D%7D) %22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22remarkable-mcp%22%5D%2C%22env%22%3A%7B%22REMARKABLE_TOKEN%22%3A%22%24%7Binput%3Atoken%7D%22%2C%22GOOGLE_VISION_API_KEY%22%3A%22%24%7Binput%3Agoogle_vision_api_key%7D%22%7D%7D&quality=insiders)

Or configure manually in .vscode/mcp.json:

{

"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](docs/tools.md)

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 document

remarkable_read("Meeting Notes")

Search for keywords

remarkable_read("Project Plan", grep="deadline")

Enable OCR for handwritten notes

remarkable_read("Journal", include_ocr=True)

Browse your library

remarkable_browse("/Work/Projects")

Filter by tags

remarkable_browse("/", tags=["important"]) remarkable_browse("/Work", tags=["project", "active"])

Search across documents

remarkable_search("meeting", grep="action items")

Search wi