The end-to-end version: what you need, how the connection actually works, the steps for every place you use Claude, and what to do when a note doesn't show up. About five minutes, most of it reading.
Your reMarkable already syncs to reMarkable's cloud — that's how the official apps see your notes. remarkdown sits between Claude and that cloud. Claude talks to remarkdown over MCP, the protocol AI assistants use to call outside tools. remarkdown talks to the reMarkable cloud with a device token your tablet issues. Your tablet picks up changes the next time it syncs.
Three things follow from that, and they explain most of what surprises people:
The engineering write-up — tokens, storage, the conversion pipeline →
That's the tablet side, done permanently. Everything after this happens inside Claude.
One connection URL, and every Claude surface uses the same one. Pick yours:
Web & desktop · custom connector
Open Claude connector settings →
Paste this URL as the MCP server URL:
https://mcp.remarkdown.org/mcpremarkdown.Requires a Pro, Max, Team, or Enterprise plan.
macOS & Windows · config file
Open Settings → Connectors → Add custom connector and paste this URL:
https://mcp.remarkdown.org/mcpOr edit the config file directly:
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"remarkdown": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.remarkdown.org/mcp"
]
}
}
}Restart Claude Desktop. A browser window opens the first time to sign you in.
CLI · one command
claude mcp add --transport http --scope user remarkdown https://mcp.remarkdown.org/mcpThen run /mcp inside Claude Code and pick remarkdown to authenticate. Drop --scope user if you only want it in this project.
Using something else? Cursor, Gemini CLI, ChatGPT, and any other MCP client →
In any Claude conversation:
Claude converts the markdown and uploads it. The document lands in your connected folder as a real reMarkable notebook — not a flat PDF, so you can write on it with the pen, mark it up, and file it like anything else on the tablet.
If it isn't there yet, the tablet hasn't synced. Put it on Wi-Fi and give it a moment.
Pushing notes to the tablet is free and uncapped. Claude opening your notebooks is the paid half.
Check the connector card in Claude's settings — it should read as connected, not offer a Connect button. If the authorization lapsed, click Connect and sign in again. And sometimes Claude simply doesn't reach for the tool on its own. Name it in the prompt: “use remarkdown to…”
Almost always the tablet hasn't synced — put it on Wi-Fi and wait. Then look inside your connected folder rather than at the top level, because that's where pushes land. If Claude reported an error rather than a success, the push didn't happen at all; your dashboard's activity log will say so.
Reading needs Pro with Document Reading switched on, and the document has to sit inside your connected folder — subfolders count. If it's outside, move it in, or change the connected folder on your dashboard.
The library index refreshes about every ten minutes, so a note you made two minutes ago can be missing. Ask Claude to refresh your reMarkable documents and look again — it re-reads the library on the spot.
Still stuck? support@remarkdown.org. We answer.
For every paired account we store your email, an encrypted device token, an audit log of tool calls (the action and the document title, never the contents), and an index of your document and folder names. Note contents are stored only on Pro with Document Reading enabled, only for your connected folder, and that copy goes away when you turn reading off. We never see your reMarkable password. No ads, nothing sold — you pay for Pro, that's the business.
Pair once. After that it's just asking Claude.