# reMarkable MCP Server

Gives an AI agent access to a reMarkable library to browse documents, search their contents and extract handwriting with OCR.

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

## What it does

The server lets an agent browse folders, read documents, search across files and retrieve page images. It extracts text from PDFs, EPUBs and typed notes. Reading a document indexes its text for later full-text searches.

Handwriting OCR uses sampling: page images go to the MCP client’s AI model for text extraction. The client must support sampling, while OCR needs no separate API key. The server connects through the reMarkable Cloud API, so a reMarkable Connect subscription and token are required. Read and search tools are read-only; folder management allows renaming, moving and creating folders, but not deleting files.

## 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 rm-mcp -e REMARKABLE_TOKEN=<REMARKABLE_TOKEN> -- uvx rm-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from rm-mcp <command>

### Codex

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

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "wavyrai-remarkable-mcp-server": {
            "command": "uvx",
            "args": [
                "rm-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 rm-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "wavyrai-remarkable-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "rm-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 rm-mcp <command>

### Gemini CLI

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

## When to use it
- search a reMarkable library for a specific passage
- extract text from PDFs and EPUBs
- turn handwritten notes into searchable text
- read selected pages from a document
- view recent documents and page images

## Example prompts
- Search my reMarkable library for notes about the project deadline.
- Read pages 1–3 of `Research Paper` and extract their text.
- Use OCR to transcribe the handwritten entries in `Journal`.

## 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

## Other versions with the same name
- [reMarkable MCP Server · sammorrowdrums](https://affpapa.org/en/nevibecode/mcp/remarkable-mcp-server.md) — ★ 252

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