Remarkable
MCP server for accessing reMarkable tablet data - sync files, extract text from highlights, and browse your reMarkable cloud
What is Remarkable?
Remarkable is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for accessing remarkable tablet data - sync files, extract text from highlights, and browse your remarkable cloud
MCP server for accessing reMarkable tablet data - sync files, extract text from highlights, and browse your reMarkable cloud
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for accessing reMarkable tablet data - sync files
Use Cases
Maintainer
Works with
Installation
NPM
npx -y remarkable-mcpPIP
pip install remarkable-mcpManual Installation
npx -y remarkable-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Remarkable
The reMarkable MCP server connects AI assistants to your reMarkable paper tablet, exposing its documents, notebooks, and highlights as readable, searchable content. It supports three connection modes — cloud (via reMarkable Connect), USB, and SSH — and offers OCR for handwritten notes using Google Vision, Tesseract, or a built-in sampling method. Writers, students, and researchers use it to search across handwritten notes, extract text from highlights, upload PDFs, and reorganize their tablet library entirely through natural language.
Prerequisites
- A reMarkable tablet (reMarkable 2 or reMarkable Paper Pro)
- For cloud mode: an active reMarkable Connect subscription and a one-time registration code from the reMarkable app
- For USB mode: tablet connected via USB with 'USB web interface' enabled in tablet Settings
- For SSH mode: developer mode enabled on the tablet
- uvx (from the uv Python package manager) or pip to install remarkable-mcp
Choose your connection mode
Cloud mode requires a reMarkable Connect subscription but works wirelessly. USB mode requires a cable but no subscription. SSH mode requires developer mode. Pick the mode that fits your setup.
Register with the cloud API (cloud mode only)
Get a one-time code from the reMarkable mobile app under Settings > Pair new device, then run the registration command. Your token is saved locally for future use.
uvx remarkable-mcp --register YOUR_ONE_TIME_CODEStart the server in your chosen mode
Run the server with the appropriate flag. For USB, connect the tablet first; for SSH, ensure SSH access is configured.
# Cloud (wireless):
uvx remarkable-mcp
# USB:
uvx remarkable-mcp --usb
# SSH:
uvx remarkable-mcp --sshSet optional environment variables
Configure OCR and other options via environment variables before starting the server.
export GOOGLE_VISION_API_KEY=your_key_here
export REMARKABLE_OCR_BACKEND=google
export REMARKABLE_ROOT_PATH=/WorkAdd to your MCP client configuration
Configure your MCP client (e.g., Claude Desktop) to launch the reMarkable MCP server automatically.
{
"mcpServers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp"],
"env": {
"GOOGLE_VISION_API_KEY": "your_key_here",
"REMARKABLE_OCR_BACKEND": "google"
}
}
}
}Remarkable Examples
Client configuration (Claude Desktop)
Launch the reMarkable MCP server via uvx with cloud mode and Google Vision OCR.
{
"mcpServers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp"],
"env": {
"GOOGLE_VISION_API_KEY": "your-google-vision-key",
"REMARKABLE_OCR_BACKEND": "google",
"REMARKABLE_ROOT_PATH": "/"
}
}
}
}Prompts to try
Use these prompts with Claude Desktop after connecting the reMarkable MCP server.
- "Browse my reMarkable and show me all documents in the /Work folder."
- "Read my 'Meeting Notes' notebook and summarize the action items."
- "Search all my reMarkable documents for mentions of 'project deadline'."
- "Show me the 10 most recently modified documents on my tablet."
- "Upload this PDF to my reMarkable tablet: /Users/me/Downloads/article.pdf"Troubleshooting Remarkable
Registration fails or returns an invalid token error
One-time codes expire quickly. Generate a fresh code in the reMarkable app (Settings > Pair new device) and immediately run `uvx remarkable-mcp --register YOUR_CODE`. Do not reuse codes.
USB mode cannot find the tablet
Enable 'USB web interface' on the tablet under Settings > Storage and make sure the tablet is unlocked. On macOS, the tablet appears at 10.11.99.1 by default; verify with `ping 10.11.99.1`.
OCR results are poor or empty for handwritten notes
Set REMARKABLE_OCR_BACKEND=google and provide a valid GOOGLE_VISION_API_KEY for best results. Alternatively use `tesseract` if Tesseract is installed locally, or `sampling` as a zero-dependency fallback.
Frequently Asked Questions about Remarkable
What is Remarkable?
Remarkable is a Model Context Protocol (MCP) server that mcp server for accessing remarkable tablet data - sync files, extract text from highlights, and browse your remarkable cloud It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Remarkable?
Install via npm with the command: npx -y remarkable-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Remarkable?
Remarkable works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Remarkable free to use?
Yes, Remarkable is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Remarkable Alternatives — Similar File Systems Servers
Looking for alternatives to Remarkable? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Remarkable in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Remarkable?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.