Remarkable MCP

🚀 reMarkable MCP Server

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

✨ Features

Your reMarkable tablet is a powerful tool for thinking, note-taking, and research. However, the knowledge on it remains confined to the device. This MCP server changes that:

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

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

🚀 Quick Start

📦 Installation

⚡ SSH Mode (Recommended)

Connect directly via USB for 10 - 100x faster access, offline operation, and no subscription required.

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 (Alternative)

If you can't enable developer mode, use the Cloud API. Requires a reMarkable Connect subscription.

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}"
      }
    }
  }
}

💻 Usage Examples

Basic 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")

# Search across documents
remarkable_search("meeting", grep="action items")

# Get recent documents
remarkable_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 tools
remarkable_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 compositing
remarkable_image("Logo Sketch", background="#00000000")

# Compatibility mode: return resource URI instead of embedded resource
remarkable_image("Diagram", compatibility=True)

Advanced Usage

All tools are read - only and return structured JSON with hints for next actions. The smart features of these tools provide more convenient usage scenarios, such as:

• 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)

📚 Documentation

Tools

📖 Full Tools Documentation

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
# macOS
brew install tesseract

# Ubuntu/Debian
sudo apt install tesseract-ocr

# Windows
choco 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.

Guides

🔧 Technical Details

Development

git clone https://github.com/SamMorrowDrums/remarkable-mcp.git
cd remarkable-mcp
uv sync --all-extras
uv run pytest test_server.py -v

📖 Development Guide

📄 License

MIT

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