Server data from the Official MCP Registry
Read, write, and manage your reMarkable tablet — browse, upload, create folders, move, delete, OCR
Read, write, and manage your reMarkable tablet — browse, upload, create folders, move, delete, OCR
Valid MCP server (2 strong, 2 medium validity signals). 5 known CVEs in dependencies (1 critical, 4 high severity) Package registry verified. Imported from the Official MCP Registry.
4 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: REMARKABLE_SSH_HOST
Environment variable: REMARKABLE_SSH_PASSWORD
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-praveensehgal-remarkable": {
"env": {
"REMARKABLE_SSH_HOST": "your-remarkable-ssh-host-here",
"REMARKABLE_SSH_PASSWORD": "your-remarkable-ssh-password-here"
},
"args": [
"remarkable-mcp-rw"
],
"command": "uvx"
}
}
}From the project's GitHub README.
Unlock the full potential of your reMarkable tablet as a second brain for AI assistants. This MCP server lets Claude, VS Code Copilot, and other AI tools read, search, and traverse your entire reMarkable library — including handwritten notes via OCR.
Your reMarkable tablet is a powerful tool for thinking, note-taking, and research. But that knowledge stays trapped on the device. This MCP server changes that:
Whether you're researching, writing, or developing ideas, remarkable-mcp lets you leverage everything on your reMarkable through AI.
Connect via USB and enable the web interface in your tablet's Storage Settings.
Setup:
Why USB Web?
Add to .vscode/mcp.json:
{
"servers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp", "--usb"],
"env": {
"GOOGLE_VISION_API_KEY": "your-api-key"
}
}
}
}
Troubleshooting:
http://10.11.99.1For power users who need direct filesystem access. Faster than USB Web but requires developer mode (factory reset).
Requirements: Developer mode enabled + USB connection to your reMarkable
Add to .vscode/mcp.json:
{
"servers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp", "--ssh"],
"env": {
"GOOGLE_VISION_API_KEY": "your-api-key"
}
}
}
}
See SSH Setup Guide for detailed instructions.
For wireless or remote access when USB isn't available. Requires a reMarkable Connect subscription and is significantly slower than USB modes.
Go to my.remarkable.com/device/desktop/connect and generate a code.
uvx remarkable-mcp --register YOUR_CODE
Or configure manually in .vscode/mcp.json:
{
"inputs": [
{
"type": "promptString",
"id": "remarkable-token",
"description": "reMarkable API Token",
"password": true
},
{
"type": "promptString",
"id": "google-vision-key",
"description": "Google Vision API Key",
"password": true
}
],
"servers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp"],
"env": {
"REMARKABLE_TOKEN": "${input:remarkable-token}",
"GOOGLE_VISION_API_KEY": "${input:google-vision-key}"
}
}
}
}
Choose the connection method that works best for you:
| Mode | Setup Difficulty | Speed | Requirements | Best For |
|---|---|---|---|---|
| 🔌 USB Web (Recommended) | ✅ Easy | Fast | USB cable, enable in Storage Settings | Everyone |
| ⚡ SSH | ⚠️ Advanced | Very Fast | Developer mode, USB connection | Power users |
| ☁️ Cloud | ✅ Easy | Slow | reMarkable Connect subscription | Remote/wireless access |
📖 Detailed Setup Guides:
remarkable-mcp works as an OpenClaw skill. Add to your openclaw.json:
{
"mcpServers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp", "--usb"]
}
}
}
Install from ClawHub:
clawhub install remarkable-mcp
Or copy the SKILL.md from this repository into your ~/.openclaw/skills/remarkable-mcp/ directory.
| Tool | Description |
|---|---|
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 |
remarkable_image | Get PNG/SVG images of pages (supports OCR via sampling) |
remarkable_upload | Upload a PDF or EPUB file to a folder on the tablet |
remarkable_mkdir | Create folders with nested path support (mkdir -p) |
remarkable_delete | Delete a document or folder (destructive) |
remarkable_move | Move or rename documents and folders |
All tools return structured JSON with hints for next actions.
Add to your ~/.claude/settings.json:
{
"mcpServers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp-rw", "--wifi"],
"env": {
"REMARKABLE_HOST": "http://YOUR_TABLET_IP"
}
}
}
}
REMARKABLE_HOST to http://YOUR_IP in the config above# Read a document
remarkable_read("Meeting Notes")
# Search for keywords
remarkable_read("Project Plan", grep="deadline")
# Enable OCR for handwritten notes
remarkable_read("Journal", include_ocr=True)
# Browse your library
remarkable_browse("/Work/Projects")
# Filter by tags
remarkable_browse("/", tags=["important"])
remarkable_browse("/Work", tags=["project", "active"])
# Search across documents
remarkable_search("meeting", grep="action items")
# Search with tag filter
remarkable_search("project", tags=["work"])
# Get recent documents
remarkable_recent(limit=10)
# Get a page image (for visual content like UI mockups or diagrams)
remarkable_image("UI Mockup", page=1)
# Get SVG for editing in design tools
remarkable_image("Wireframe", output_format="svg")
# Get image with OCR text extraction (uses sampling if configured)
remarkable_image("Handwritten Notes", include_ocr=True)
# Transparent background for compositing
remarkable_image("Logo Sketch", background="#00000000")
# Compatibility mode: return resource URI instead of embedded resource
remarkable_image("Diagram", compatibility=True)
Documents are automatically registered as MCP resources:
| URI Scheme | Description |
|---|---|
remarkable:///{path}.txt | Extracted text content |
remarkableraw:///{path}.pdf | Original PDF file (SSH only) |
remarkableraw:///{path}.epub | Original EPUB file (SSH only) |
remarkableimg:///{path}.page-{N}.png | PNG image of page N (notebooks only) |
remarkablesvg:///{path}.page-{N}.svg | SVG vector image of page N (notebooks only) |
📖 Full Resources Documentation
For handwritten content, remarkable-mcp offers several OCR backends. Choose based on your setup and requirements:
| Backend | Setup | Quality | Offline | Best For |
|---|---|---|---|---|
| Sampling | No API key | Depends on client model | ✅ | Users with capable AI clients |
| Google Vision | API key | Excellent | ❌ | Best handwriting accuracy |
| Tesseract | System install | Poor for handwriting | ✅ | Printed text, offline fallback |
Set REMARKABLE_OCR_BACKEND in your MCP config:
{
"env": {
"REMARKABLE_OCR_BACKEND": "sampling"
}
}
Options: sampling, google, tesseract, auto
Uses your MCP client's AI model for OCR. Works with clients that support MCP sampling (VS Code + Copilot, Claude Desktop, etc.).
Pros:
Cons:
Provides consistently excellent handwriting recognition.
Setup:
"GOOGLE_VISION_API_KEY": "your-key"Cost: 1,000 free requests/month, then ~$1.50 per 1,000.
📖 Full Google Vision Setup Guide
Open-source OCR designed for printed text. Poor results with handwriting, but useful as an offline fallback.
# Install Tesseract
# macOS
brew install tesseract
# Ubuntu/Debian
sudo apt install tesseract-ocr
# Windows
choco install tesseract
auto)When REMARKABLE_OCR_BACKEND=auto (default):
GOOGLE_VISION_API_KEY is set)| Feature | SSH Mode | Cloud API |
|---|---|---|
| Speed | ⚡ 10-100x faster | Slower |
| Offline | ✅ Yes | ❌ No |
| Subscription | ✅ Not required | ❌ Connect required |
| Raw files | ✅ PDFs, EPUBs | ❌ Not available |
| Setup | Developer mode | One-time code |
Limit the MCP server to a specific folder on your reMarkable. All operations will be scoped to this folder:
{
"servers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp", "--ssh"],
"env": {
"REMARKABLE_ROOT_PATH": "/Work",
"GOOGLE_VISION_API_KEY": "your-api-key"
}
}
}
}
With this configuration:
remarkable_browse("/") shows contents of /Workremarkable_browse("/Projects") shows /Work/Projects/Work are not accessibleUseful for:
Set the default background color for image rendering:
{
"servers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp", "--ssh"],
"env": {
"REMARKABLE_BACKGROUND_COLOR": "#FFFFFF"
}
}
}
}
Supported formats:
#RRGGBB — RGB hex (e.g., #FFFFFF for white)#RRGGBBAA — RGBA hex (e.g., #00000000 for transparent)Default is #FBFBFB (reMarkable paper color). This affects both the remarkable_image tool and image resources.
Use remarkable-mcp while working in an Obsidian vault or similar to transfer knowledge from your handwritten notes into structured documents. AI can read your research notes and help develop your ideas.
Ask your AI assistant to summarize your recent notes, find action items, or identify patterns across your journal entries.
Find that half-remembered note by searching across your entire library — including handwritten content.
Treat your reMarkable as a second brain that AI can access. Combined with tools like Obsidian, you can build a powerful personal knowledge system.
| Guide | Description |
|---|---|
| SSH Setup | Enable developer mode and configure SSH |
| Google Vision Setup | Set up handwriting OCR |
| Tools Reference | Detailed tool documentation |
| Resources Reference | MCP resources documentation |
| Capability Negotiation | MCP protocol capabilities |
| Development | Contributing and development setup |
| Future Plans | Roadmap and planned features |
git clone https://github.com/SamMorrowDrums/remarkable-mcp.git
cd remarkable-mcp
uv sync --all-extras
uv run pytest test_server.py -v
MIT
Built with rmscene, PyMuPDF, and inspiration from ddvk/rmapi.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.