reMarkable MCP Server

Entfesseln Sie das volle Potenzial Ihres reMarkable-Tablets als zweites Gehirn für KI-Assistenten. Dieser MCP-Server ermöglicht es Claude, VS Code Copilot und anderen KI-Tools, Ihre gesamte reMarkable-Bibliothek zu lesen, zu durchsuchen und zu durchblättern – einschließlich handschriftlicher Notizen per OCR.

Warum rm-mcp?

Ihr reMarkable-Tablet ist ein leistungsstarkes Werkzeug zum Denken, Notieren und Recherchieren. Aber dieses Wissen bleibt auf dem Gerät gefangen. Dieser MCP-Server ändert das:

• Vollständiger Bibliothekszugriff – Ordner durchsuchen, Dokumente suchen, jede Datei lesen

• Extraktion von getipptem Text – Native Unterstützung für Type Folio und getippte Anmerkungen

• Handschrift-OCR – Handschriftliche Notizen in durchsuchbaren Text umwandeln

• PDF- und EPUB-Unterstützung – Text aus Dokumenten extrahieren, plus Ihre Anmerkungen

• Intelligente Suche – Inhalte in Ihrer gesamten Bibliothek finden

• Organisieren Sie Ihre Bibliothek – Umbenennen, Verschieben und Erstellen von Ordnern (es wird nie etwas gelöscht)

• Second-Brain-Integration – Verwenden Sie es mit Obsidian, Notiz-Apps oder jedem KI-Workflow

Egal ob Sie recherchieren, schreiben oder Ideen entwickeln – rm-mcp ermöglicht es Ihnen, alles auf Ihrem reMarkable über KI zu nutzen.

Related MCP server: io.github.praveensehgal/remarkable

Schnellinstallation

Verwendet die reMarkable Cloud API. Erfordert ein reMarkable Connect-Abonnement.

Ein-Befehl-Setup (empfohlen)

uvx rm-mcp --setup

Dies öffnet Ihren Browser, fordert zur Eingabe des Einmalcodes auf und gibt die fertige Konfiguration für Claude Code und Claude Desktop aus.

Manuelle Einrichtung

1. Einmalcode abrufen

Gehen Sie zu my.remarkable.com/device/browser/connect und generieren Sie einen Code.

2. In Token umwandeln

uvx rm-mcp --register YOUR_CODE

3. Zu Ihrem MCP-Client hinzufügen

Claude Code:

claude mcp add remarkable \
  -e REMARKABLE_TOKEN='<paste token from step 2>' \
  -e REMARKABLE_OCR_BACKEND=sampling \
  -- uvx rm-mcp@latest

Claude Desktop – fügen Sie zu claude_desktop_config.json hinzu (verwenden Sie den vollständigen Pfad zu uvx, z. B. von which uvx):

{
  "mcpServers": {
    "remarkable": {
      "command": "/Users/YOU/.local/bin/uvx",
      "args": ["rm-mcp@latest"],
      "env": {
        "REMARKABLE_TOKEN": "<paste token from step 2>"
      }
    }
  }
}

Werkzeuge

Alle Werkzeuge sind schreibgeschützt und geben strukturiertes JSON mit Hinweisen für nächste Aktionen zurück.

📖 Vollständige Werkzeugdokumentation

Intelligente Funktionen

• Mehrseitiges Lesen – Alle Seiten auf einmal lesen mit pages="all" oder einem Bereich wie pages="1-3"

• Grep-Autoumleitung – grep findet automatisch die passende Seite und springt dorthin

• Automatische Umleitung – Beim Durchsuchen eines Dokumentpfads wird dessen Inhalt automatisch zurückgegeben

• Auto-OCR – Notizbücher ohne getippten Text aktivieren automatisch OCR (deaktivierbar mit auto_ocr=False)

• Volltextsuche – Beim Lesen eines Dokuments wird es für schnelle zukünftige Suchen indiziert

• Kompaktmodus – Verwenden Sie compact_output=True, um den Token-Verbrauch in Antworten zu reduzieren

• Stapelsuche – Durchsuchen Sie mehrere Dokumente in einem Aufruf

• Vision-Unterstützung – Seitenbilder für visuellen Kontext abrufen (Diagramme, Mockups, Skizzen)

• Sampling-OCR – KI des Clients für OCR auf Bildern verwenden (kein API-Schlüssel erforderlich)

Beispielverwendung

# Read a document
remarkable_read("Meeting Notes")

# Read all pages at once
remarkable_read("Meeting Notes", pages="all")

# Read a range of pages
remarkable_read("Research Paper", pages="1-3")

# Search for keywords (auto-redirects to matching page)
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 with previews
remarkable_recent(limit=5, include_preview=True)

# Get a page image
remarkable_image("UI Mockup", page=1)

# Get image with OCR text extraction
remarkable_image("Handwritten Notes", include_ocr=True)

Ressourcen

Dokumente werden automatisch als MCP-Ressourcen registriert:

📖 Vollständige Ressourcendokumentation

OCR für Handschrift

rm-mcp verwendet Sampling-OCR – das KI-Modell Ihres MCP-Clients extrahiert Text aus handschriftlichen Notizen. Keine zusätzlichen API-Schlüssel oder Dienste erforderlich.

So funktioniert es

Wenn Sie include_ocr=True verwenden, sendet rm-mcp Seitenbilder an das LLM Ihres Clients (Claude, GPT-4 usw.) über MCP-Sampling. Das Modell liest die Handschrift und gibt den Text zurück.

Verwendung

# OCR on a page image
remarkable_image("Handwritten Notes", include_ocr=True)

# OCR when reading a notebook
remarkable_read("Journal", include_ocr=True)

Anforderungen

• Ihr MCP-Client muss die Sampling-Fähigkeit unterstützen (VS Code + Copilot, Claude Desktop usw.)

• REMARKABLE_OCR_BACKEND=sampling (dies ist die Standardeinstellung)

Erweiterte Konfiguration

Root-Pfad-Filterung

Beschränken Sie den MCP-Server auf einen bestimmten Ordner auf Ihrem reMarkable. Alle Vorgänge werden auf diesen Ordner beschränkt:

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["rm-mcp"],
      "env": {
        "REMARKABLE_TOKEN": "your-token",
        "REMARKABLE_ROOT_PATH": "/Work"
      }
    }
  }
}

Mit dieser Konfiguration:

• remarkable_browse("/") zeigt den Inhalt von /Work

• remarkable_browse("/Projects") zeigt /Work/Projects

• Dokumente außerhalb von /Work sind nicht zugänglich

Nützlich für:

• Konzentration auf Arbeitsdokumente während der Bürozeiten

• Trennung von persönlichen und beruflichen Notizen

• Eingrenzung des Umfangs für bestimmte KI-Workflows

Benutzerdefinierte Hintergrundfarbe

Legen Sie die Standard-Hintergrundfarbe für die Bilddarstellung fest:

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["rm-mcp"],
      "env": {
        "REMARKABLE_TOKEN": "your-token",
        "REMARKABLE_BACKGROUND_COLOR": "#FFFFFF"
      }
    }
  }
}

Unterstützte Formate:

• #RRGGBB – RGB-Hex (z. B. #FFFFFF für Weiß)

• #RRGGBBAA – RGBA-Hex (z. B. #00000000 für transparent)

Standard ist #FBFBFB (reMarkable-Papierfarbe). Dies betrifft sowohl das remarkable_image-Werkzeug als auch Bildressourcen.

Alle Umgebungsvariablen

Die meisten Benutzer benötigen nur REMARKABLE_TOKEN. Der Rest dient der erweiterten Feinabstimmung.

Anwendungsfälle

Recherche & Schreiben

Verwenden Sie rm-mcp, während Sie in einem Obsidian-Vault oder ähnlichem arbeiten, um Wissen aus Ihren handschriftlichen Notizen in strukturierte Dokumente zu übertragen. KI kann Ihre Forschungsnotizen lesen und bei der Entwicklung Ihrer Ideen helfen.

Tägliche Überprüfung

Bitten Sie Ihren KI-Assistenten, Ihre letzten Notizen zusammenzufassen, Aktionspunkte zu finden oder Muster in Ihren Tagebucheinträgen zu erkennen.

Dokumentsuche

Finden Sie diese halb erinnerte Notiz, indem Sie Ihre gesamte Bibliothek durchsuchen – einschließlich handschriftlicher Inhalte.

Wissensmanagement

Behandeln Sie Ihr reMarkable als zweites Gehirn, auf das KI zugreifen kann. In Kombination mit Tools wie Obsidian können Sie ein leistungsstarkes persönliches Wissenssystem aufbauen.

Dokumentation

Entwicklung

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

📖 Entwicklungsleitfaden

Lizenz

MIT

Erstellt mit rmscene, PyMuPDF und Inspiration von ddvk/rmapi.