reMarkable MCP Server — Claude Code MCP server: how to install
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.
claude mcp add remarkable -e REMARKABLE_TOKEN=<REMARKABLE_TOKEN> -- uvx remarkable-mcpWhat reMarkable MCP Server 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.
What it helps with
- 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 for the agent
- 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
How to install reMarkable MCP Server
Platform CLI
claude mcp add remarkable -e REMARKABLE_TOKEN=<REMARKABLE_TOKEN> -- uvx remarkable-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remarkable-mcp <command>
Platform CLI
codex mcp add remarkable-mcp-server --env REMARKABLE_TOKEN=<REMARKABLE_TOKEN> -- uvx remarkable-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remarkable-mcp <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add -e REMARKABLE_TOKEN=<REMARKABLE_TOKEN> remarkable-mcp-server uvx remarkable-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remarkable-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about reMarkable MCP Server
How to install reMarkable MCP Server in Claude Code?
Run claude mcp add remarkable -e REMARKABLE_TOKEN=<REMARKABLE_TOKEN> -- uvx remarkable-mcp in your terminal. Ensure uv is installed on your system before adding the server.
What does reMarkable MCP Server do?
It connects your reMarkable tablet data to MCP-enabled tools. You can view directories, transcribe handwritten text, render page images, and push files back to the device.
Do I need a reMarkable Connect subscription?
Only if you choose cloud mode. Both USB web mode and offline desktop directory reading work without any active subscription.
