← 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.
GitHub source repository ↗
★ 210 Stars Category · Cloud Storage Popular Source revision d8e6f2265a76
65FMRS · C
Reliability
10/20
Security and permissions
12/20
Maintenance
14/20
Documentation
16/20
Setup experience
13/20

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.

Read the FMRS scoring method →

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.

Tools

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

Setup

  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).
claude_desktop_config.json
{
  "mcpServers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--usb"],
      "env": {
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

Fit and risk

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.

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

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

ClaudeFull support
VS Code CopilotFull support
ChatGPTFull support