remarkable-mcp
Enables conversion of hand-drawn diagrams from reMarkable pages into interactive Excalidraw diagrams.
Enables transcription of handwritten notes from reMarkable pages into clean Markdown format.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@remarkable-mcp Transcribe the last 3 pages of my journal"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
remarkable-mcp
An MCP server that gives Claude direct access to your reMarkable tablet's notebooks. Search documents, render handwritten pages to PDF, and let Claude transcribe your handwriting or convert hand-drawn diagrams into editable formats — all from your local machine, no API keys required.
How it works
The reMarkable desktop app syncs your notebooks to a local cache. This MCP server reads that cache and exposes it as tools that Claude can use directly.
reMarkable tablet
→ reMarkable desktop app (cloud sync)
→ Local cache (~/.../remarkable/desktop)
→ remarkable-mcp (rmc → SVG → cairosvg → PDF)
→ Claude reads the PDF
→ Clean Markdown, Excalidraw diagrams, or whatever you needNo API keys. No cloud access. Everything runs locally. The desktop app handles syncing; this server just reads the files it produces.
Related MCP server: io.github.praveensehgal/remarkable
Prerequisites
reMarkable desktop app — installed and synced (download)
macOS — the server reads from the standard macOS cache path (Linux support is possible but untested)
Python 3.12+
uv — Python package manager (install)
cairo — system graphics library for SVG→PDF rendering:
brew install cairo
Installation
git clone https://github.com/sambt94/remarkable-mcp.git
cd remarkable-mcp
uv syncMCP Registration
Add the server to your Claude Code MCP configuration. See mcp.example.json for the full template, or add this to your .mcp.json:
{
"mcpServers": {
"remarkable": {
"type": "stdio",
"command": "/bin/bash",
"args": [
"-c",
"export DYLD_LIBRARY_PATH=/opt/homebrew/lib; exec uv --directory '/path/to/remarkable-mcp' run server.py"
]
}
}
}Replace /path/to/remarkable-mcp with the actual path to your cloned repo.
The DYLD_LIBRARY_PATH is needed so Python can find the Homebrew-installed cairo library on macOS.
Tools
The server exposes 6 tools:
Tool | Description |
| Diagnostics — cache exists? rmc available? cairo available? |
| Search/list documents in the cache (optional substring filter) |
| Detailed metadata for a document (page count, page IDs, format) |
| Render selected pages to a single PDF |
| Render all pages of a document to PDF |
| Remove temporary rendered PDFs |
Page selection
remarkable_render_pages supports flexible page selection:
# Last 5 pages of a document
remarkable_render_pages(doc_id="<uuid>", last_n=5)
# First 3 pages
remarkable_render_pages(doc_id="<uuid>", first_n=3)
# Specific pages (0-indexed)
remarkable_render_pages(doc_id="<uuid>", page_indices=[0, 2, 4])
# All pages (no selection args)
remarkable_render_pages(doc_id="<uuid>")Priority: page_indices > last_n > first_n > all pages.
Usage with Claude
Once registered, Claude can access your reMarkable notebooks directly:
"Transcribe the last 3 pages of my journal"
"Find my notebook called 'Architecture Notes' and render page 5"
"What documents do I have on my reMarkable?"
The rendered PDFs are saved to /tmp/remarkable-renders/ and can be cleaned up with remarkable_cleanup_renders.
Companion Skills
The skills/ directory contains Claude Code skill definitions that wrap the MCP tools into complete workflows:
remarkable-transcribe.md— Transcribe handwritten notes to clean Markdownremarkable-diagram.md— Convert hand-drawn diagrams to interactive Excalidraw files
To use these, copy the skill files into your ~/.claude/skills/ directory (or symlink them).
Architecture
remarkable-mcp/
├── server.py # MCP server entry point (FastMCP, stdio transport)
├── remarkable_client.py # Client library (cache reading, rendering pipeline)
├── skills/
│ ├── remarkable-transcribe.md # Handwriting → Markdown skill
│ └── remarkable-diagram.md # Diagram → Excalidraw skill
└── tests/
├── conftest.py # Synthetic cache fixtures
├── test_remarkable_client.py # Unit tests
├── test_server.py # Integration tests
└── test_e2e.py # End-to-end stdio testsThe rendering pipeline:
rmc parses reMarkable's proprietary
.rmbinary format (v6) into SVGcairosvg converts SVG to PDF
pypdf merges per-page PDFs into a single document
Claude reads the PDF and does whatever you need — transcription, diagram interpretation, summarization
Tests
# All tests
uv run pytest tests/ -v
# By category
uv run pytest tests/ -m unit # unit tests (synthetic cache)
uv run pytest tests/ -m integration # tool registration and response shapes
uv run pytest tests/ -m e2e # full stdio transportTests use synthetic fixtures — no real reMarkable device or cache required.
License
MIT — see LICENSE.
Available Tools
6 toolsremarkable_check_statusA
Check reMarkable system status and tool availability. Returns whether the cache exists, document count, and rmc/cairo availability. Use this to diagnose issues before rendering.
Inputs: no named parameters. Returns: object
remarkable_cleanup_rendersA
Remove temporary rendered PDFs from the render directory. Returns the number of files removed and bytes freed. Call this after you're done reading rendered PDFs.
Inputs: no named parameters. Returns: object
remarkable_get_document_infoA
Get detailed metadata for a single reMarkable document. Returns document ID, name, page count, page IDs, and content format (v1/v2). Lightweight — reads JSON only, no rendering.
Inputs: doc_id (required). Returns: object
remarkable_list_documentsA
List documents in the reMarkable local cache. Optional case-insensitive substring filter on document names. Returns document IDs, names, page counts, and last modified timestamps.
Inputs: search. Returns: object
remarkable_render_documentA
Render all pages of a reMarkable document to a single PDF. Convenience wrapper — equivalent to render_pages with no selection args. Returns the PDF path, document name, pages rendered/failed, and indices.
Inputs: doc_id (required). Returns: object
remarkable_render_pagesA
Render selected pages of a reMarkable document to a single PDF. Priority: page_indices > last_n > first_n > all pages. For a 200-page doc with last_n=5, only the last 5 pages are rendered. Returns the PDF path, document name, pages rendered/failed, and indices.
Inputs: doc_id (required), last_n, first_n, page_indices. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have clearly distinct purposes, but remarkable_render_document is explicitly a wrapper for remarkable_render_pages with no selection arguments, creating a slight overlap. The descriptions mitigate this by clarifying the relationship, so it's mostly unambiguous.
All tools follow a consistent verb_noun pattern with the remarkable_ prefix, such as list_documents, render_pages, and check_status. This makes the tool names predictable and easy to navigate.
With 6 tools, the server is well-scoped for its purpose of managing and rendering reMarkable documents. Each tool serves a distinct function (listing, metadata, rendering, status, cleanup) without unnecessary bloat.
The tool set covers the core lifecycle for reading and rendering documents: listing, retrieving metadata, rendering all or select pages, checking status, and cleaning up. It lacks write operations like upload or delete, but those fall outside the apparent scope of a rendering-focused server.
Maintenance
Related MCP Connectors
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives Claude AI direct access to your Obsidian vault, enabling natural language search, note creation, file management, and automated workflows.10MIT
- AlicenseAqualityDmaintenanceMCP server that connects AI assistants to your reMarkable tablet, enabling reading, searching, and traversing handwritten and typed notes via OCR.1014 PyPI3MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for Outline that gives Claude the ability to search and read documents from your Outline instance.MIT
- AlicenseNot gradedqualityDmaintenanceA local MCP server that turns an Obsidian vault into a searchable second brain for Claude with meaning-based search, note read/write, and insight reports like contradictions and stale TODOs.MIT