# reMarkable MCP Server

Connects reMarkable paper tablets to AI clients via MCP. Reads notes, runs OCR on handwritten pages, renders notebooks to images, and uploads Markdown as PDF.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 252
- Author: SamMorrowDrums
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SamMorrowDrums/remarkable-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/remarkable-mcp-server

## What it does

This server bridges MCP clients with your reMarkable library. The connected model can browse folders, filter documents by tags, extract highlights from EPUB or PDF files, and export pages as Markdown. PyMuPDF handles page rasterization directly to PNG or SVG, avoiding external Cairo or browser dependencies. OCR for handwritten entries runs through Tesseract or Google Vision.

Four connection modes exist: USB web, local desktop app folder, cloud sync, and SSH. Note that local directory mode operates strictly read-only, while cloud access requires a paid Connect subscription. You only need `uv` installed locally to execute the server via `uvx`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `REMARKABLE_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add remarkable -e REMARKABLE_TOKEN=<REMARKABLE_TOKEN> -- uvx remarkable-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remarkable-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add remarkable-mcp-server --env REMARKABLE_TOKEN=<REMARKABLE_TOKEN> -- uvx remarkable-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remarkable-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "remarkable-mcp-server": {
            "command": "uvx",
            "args": [
                "remarkable-mcp"
            ],
            "env": {
                "REMARKABLE_TOKEN": "<REMARKABLE_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remarkable-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "remarkable-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "remarkable-mcp"
            ],
            "env": {
                "REMARKABLE_TOKEN": "<REMARKABLE_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remarkable-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e REMARKABLE_TOKEN=<REMARKABLE_TOKEN> remarkable-mcp-server uvx remarkable-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remarkable-mcp <command>

## When to use it
- run OCR on handwritten notes using Google Vision or Tesseract
- search tablet documents by tags and extracted text
- render notebook pages into PNG or SVG images
- compile Markdown files into PDF format and upload them to the tablet

## Example prompts
- Find my reMarkable notes tagged with #project and summarize the extracted text
- Run OCR on page 3 of my recent notebook and output the text
- Render this Markdown summary as a PDF and upload it to my tablet

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md