← Back to directory
R

reMarkable MCP Server

Community
Use your reMarkable tablet as a second brain for AI assistants. Read documents, browse files, extract text, and OCR handwriting.
Category
Cloud Storage #3 of 15
Stars
★ 243 Popular
Transport
stdio (local process)
Runtime
Python
Credentials
Optional API key
License
MIT
Last commit
Tools
13
65FMRS · C

This server provides a powerful and flexible integration for leveraging reMarkable notes in AI workflows. It supports multiple connection modes, has comprehensive read/write tools, and offers smart features like auto-OCR and tag filtering. Active development and clear documentation add to its usability.

Strongest · Documentation 16/20 Weakest · Reliability 10/20

Reliability
10/20
Security and permissions
12/20
Maintenance
14/20
Documentation
16/20
Setup experience
13/20
Why each score
Reliability 10/20
Evidence: Repository includes test files (e.g., test_server.py) and a smoke test script (smoke/run_smoke.py); README provides a detailed tool list and transport modes. No contradictory statements found; but the server path (server.json) only provides a summary manifest, not code-level verification. Limitation: Since this is a static review and nothing is executed, and dependencies (PyMuPDF, rmscene) and external services (Google Vision) have uncontrollable failure modes, reliability is capped at 10.
Security and permissions 12/20
Evidence: Credential handling is good—REMARKABLE_TOKEN is marked secret with a registration flow; delete operation requires confirmation by default and is refused without it; read-only mode is supported; no real tokens in install examples. Limitations: Write tools are enabled by default but clearly documented; external network calls (Google Vision) lack explicit data-flow disclosure; delete confirmation depends on client support and may be skipped in some environments; no malware or overreach found, so no red-line triggered.
Maintenance 14/20
Evidence: Repository appears active (191 stars, 22 open issues), has MIT license, documented roadmap and development guide; README reflects ongoing updates. Limitations: No release cadence or versioning details, dependency updates not explicitly mentioned; maintenance score based on visible activity, but commit history and issue responses not verified.
Documentation 16/20
Evidence: Comprehensive docs covering installation (USB, SSH, cloud), OCR setup, tool reference, resource reference, troubleshooting, and capability negotiation, with examples. Limitations: Some advanced features (e.g., canvas) depend on client-specific support and lack screenshot evidence; docs are self-reported and not validated by tests.
Setup experience 13/20
Evidence: Multiple installation methods (USB, SSH, cloud) with VS Code one-click install buttons and manual JSON config examples; environment variables and API key acquisition clearly explained. Limitations: Installation depends on external tools (uvx, Google Vision, etc.) and troubleshooting is not exhaustive for all platforms; static review cannot verify actual executability of setup steps.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local filesUses the network

Best for

  • reMarkable users who want to leverage their device's notes and documents in AI workflows.
  • Remote or headless setups where device-free access is needed (cloud mode).
  • Users who prefer fast offline access over USB without subscription (USB Web mode).

Not for

  • Users without a reMarkable device or who are unwilling to manage multiple API keys.
  • Teams needing official support or enterprise SLA.
  • Users who want to customize the protocol without owning the hardware.

Required permissions

  • Requires authentication token for reMarkable Cloud API (`REMARKABLE_TOKEN`) — keep it secret.
  • USB/SSH modes require USB connection and/or SSH access to the tablet filesystem.
  • Write operations are enabled by default; destructive deletes require confirmation (if client supports elicitation) or setting `REMARKABLE_SKIP_CONFIRM=1`.
  • Optional Google Vision API key for OCR.

Risks and side effects

  • Write tools can lead to data loss; deletes are destructive and should be used with caution.
  • Cloud mode requires a reMarkable Connect subscription, which may incur costs.
  • Google Vision OCR may incur costs (1000 free requests/month, then ~$1.50 per 1000).
  • Potential exposure of sensitive notes to AI providers if not properly managed.
  • SSH mode requires developer mode, which may void warranty.

Setup

Before you start

Runtime:Python

REMARKABLE_TOKEN optionalsecret reMarkable Cloud API token; generate from a one-time code at my.remarkable.com/device/desktop/connect via `uvx remarkable-mcp --register`. Required for cloud mode.
GOOGLE_VISION_API_KEY optionalsecret Google Cloud Vision API key for handwriting OCR; create it in the Google Cloud Console credentials page.
Other optional settings (12)
REMARKABLE_OCR_BACKEND optional Select the OCR backend: sampling, google, tesseract, or auto (default).
REMARKABLE_READ_ONLY optional Set to 1 to run the server in read-only mode, disabling all write tools.
REMARKABLE_SKIP_CONFIRM optional Set to 1 to allow deletes without a prompt when the client lacks MCP elicitation support.
REMARKABLE_ROOT_PATH optional Scope all server operations to a specific folder on the reMarkable, e.g. /Work.
REMARKABLE_BACKGROUND_COLOR optional Default background color for page image rendering, #RRGGBB or #RRGGBBAA format, default #FBFBFB.
REMARKABLE_RETRY_ATTEMPTS optional Maximum number of cloud API request attempts, default 3.
REMARKABLE_RETRY_DELAY optional Base delay in seconds for exponential backoff, default 2.0.
REMARKABLE_SYNC_WORKERS optional Number of parallel workers for cloud library fetches, default 16 (clamped to 64).
REMARKABLE_DISABLE_CACHE optional Set to 1 to fully disable the on-disk blob cache in cloud mode.
REMARKABLE_CACHE_DIR optional Blob cache directory for cloud mode, default ~/.remarkable/cache/blobs.
REMARKABLE_CACHE_MAX_BLOB optional Blobs larger than this are streamed but not cached, default 4 MiB.
REMARKABLE_DISABLE_CLOUD_FALLBACK optional Set to 1 to disable automatic fallback to cloud mode when the device is unreachable.
  1. Ensure Python and uvx are installed.
  2. Choose a connection mode: USB Web (recommended) — enable 'USB web interface' in tablet Settings > Storage; SSH — enable developer mode; Cloud — get a one-time code at my.remarkable.com and convert to token with uvx remarkable-mcp --register YOUR_CODE.
  3. For handwriting OCR, obtain a Google Vision API key and set the environment variable GOOGLE_VISION_API_KEY.
  4. Add the server to your MCP client config, e.g., .vscode/mcp.json for VS Code or Claude Desktop's config.
  5. Start the MCP server with the appropriate flags (e.g., --usb, --ssh, or none for cloud).
MCP config · JSON
{
  "mcpServers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--usb"],
      "env": {
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

Works in clients that read an "mcpServers" key. For clients such as VS Code that use a different key, the configurator below converts it.

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add remarkable -e GOOGLE_VISION_API_KEY=your-api-key -- uvx remarkable-mcp --usb

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

The client's tool list should show tools like remarkable_read, remarkable_browse, and remarkable_status; calling remarkable_status confirms the active transport (USB/SSH/Cloud) and its capability matrix.

Troubleshooting

  1. USB connection fails: ensure device is unlocked and connected, verify 'USB web interface' is enabled in Settings > Storage.
  2. Cloud auth errors: check token validity, re-register if needed.
  3. OCR not working: check `REMARKABLE_OCR_BACKEND` setting and API keys.
  4. Performance issues: tune `REMARKABLE_SYNC_WORKERS` and cache settings.
  5. Connection refused: ensure network allows access to tablet IP (e.g., 10.11.99.1).

Things to try

Once connected, you can ask your AI assistant things like:

  • Read the document called Meeting Notes from my reMarkable
  • Search my whole library for 'action items', including handwritten OCR
  • Upload paper.pdf to the /Research folder on my reMarkable
  • Get a PNG image of page 1 of my UI Mockup document

Tools 13

remarkable_read read-only
Read and extract text from documents (with pagination and search).
remarkable_browse read-only
Navigate folders, search by document name, or filter by tags.
remarkable_search read-only
Search content across multiple documents (with tag filtering).
remarkable_recent read-only
Get recently modified documents.
remarkable_status read-only
Check connection status and the per-transport capability matrix.
remarkable_image read-only
Get PNG/SVG images of pages (supports OCR via sampling).
remarkable_upload writes
Upload a PDF or EPUB file to the device.
remarkable_mkdir writes
Create a new folder (cloud and SSH modes).
Show 5 more tools
remarkable_move writes
Move a document or folder (cloud and SSH modes).
remarkable_rename writes
Rename a document or folder (cloud and SSH modes).
remarkable_delete destructive
Delete a document or folder — destructive (cloud and SSH modes).
remarkable_author writes
Author native ink and notebooks (SSH only).
remarkable_canvas read-only
Open a page in the interactive canvas viewer.

Use cases

Research & writing: transfer handwritten notes to Obsidian or similar.
Daily review: AI summarizes recent notes, finds action items.
Document search: search across entire library, including handwritten content.
Knowledge management: treat reMarkable as a second brain for AI.

Supported clients

Claude
VS Code
ChatGPT

Listed from the project's documentation, not tested by this site.

Overview

The reMarkable MCP Server gives AI assistants access to all notes and documents on your reMarkable tablet. It supports browsing folders, searching documents, and reading any file, including extracting text from handwritten notes via OCR. Multiple connection modes are offered: USB Web interface (recommended, no subscription or developer mode), SSH (requires developer mode), and Cloud (requires Connect subscription, works device-free). Write tools are included (upload, create folder, move, rename, delete), and document text and page images are available as MCP resources.

Similar servers

Source revision 2ad0e1751226 Data synced 2026-10-12 Read the FMRS scoring method