remarkable-mcp

Quick Install

Quick Setup

Set REMARKABLE_OCR_BACKEND in your MCP config:

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

Options: sampling, google, tesseract, auto

<details> <summary>📖 Sampling OCR (No API Key)</summary>

Uses your MCP client's AI model for OCR. Works with clients that support MCP sampling (VS Code + Copilot, Claude Desktop, etc.).

Pros: - No additional API keys needed - Quality depends on your client's model (GPT-4, Claude, etc.) - Private — handwriting stays local to your client

Cons: - Only available with sampling-capable clients - Falls back to Google Vision (if API key configured) or Tesseract if sampling unavailable

</details>

<details> <summary>📖 Google Cloud Vision</summary>

Provides consistently excellent handwriting recognition.

Setup: 1. Enable Cloud Vision API 2. Create an API key 3. Add to config: "GOOGLE_VISION_API_KEY": "your-key"

Cost: 1,000 free requests/month, then ~$1.50 per 1,000.

📖 Full Google Vision Setup Guide

</details>

<details> <summary>📖 Tesseract (Fallback)</summary>

Open-source OCR designed for printed text. Poor results with handwriting, but useful as an offline fallback.

```bash

Install Tesseract

Example Usage

```python

Examples

```python

Use Cases

Get image with OCR text extraction (uses sampling if configured)

remarkable_image("Handwritten Notes", include_ocr=True)

Advanced Configuration

Retry Configuration

Cloud API requests automatically retry on transient failures (HTTP 429, 500, 502, 503, 504) and network errors with exponential backoff and jitter. You can tune this via environment variables:

The retry logic honours the Retry-After header from rate-limited responses — both the numeric (seconds) form and the HTTP-date form (which Cloudflare, fronting the reMarkable cloud, often sends) — capped at 20 seconds. Auth failures (401) are not retried — they trigger automatic token renewal instead.

---

🔌 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

<details> <summary>📋 Manual USB Web Configuration</summary>

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

</details>

---

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.

---

SSH vs USB Web vs Cloud Comparison

📖 SSH Setup Guide

---