MCP access

Give Claude access to your reMarkable notes.

Connect Claude Code or Claude Desktop to your library through a local MCP server. Twenty tools let a client search, read and export notes; seven can change the library when you grant permission.

The MCP server runs on your Mac and is off by default. The client can send the notes it retrieves to its model provider. Cloud recognition can also send pages to the engine you chose.

Local MCP server settings and client permissions

local access; model processing depends on your client

What it is

A way for a chat client to ask the apps on your Mac

an open protocol

  • “What did I write in Research last week?”

    Search and reading — one or two tools out of twenty.

  • “Find the notes that mention the lease”

    The search runs over text already read and sitting in the index.

  • “Put this summary in a new folder on the tablet”

    One of the seven writing tools — each needs its permission on the token, and editing mode on. Deleting asks you through the client, where the client can ask.

  • Reading starts from what was already read

    The tool hands over what the index already holds. Where it holds nothing, the document is read by the engine you chose on the Handwriting page — a cloud engine or an AI model too, if that’s your choice — and the result is stored, so a cloud read is paid for once.

  • “Give me what I marked in this book”

    Reading can hand back only the passages under a marker, with the color of each band. Another tool lists a document’s highlights by page; erasing them is a permission of its own, which a new token gets only if you tick it.

  • “Send me this document as a file”

    Export puts the file on a shelf and hands back a link good for fifteen minutes. The shelf holds no more than eight documents at once: a ninth pushes out whichever went longest unclaimed.

Which clients

Two work; cloud ones can’t connect

  • Claude Code

    works

    Over HTTP on a local address. Connecting takes one command from the docs.

  • Claude Desktop

    works

    Through a small bridge program that ships with the app.

  • claude.ai, Cowork

    not supported

    Their connectors start in the provider’s cloud and can’t reach a local address.

  • What that means

    A cloud connector can’t reach your Mac because the server isn’t reachable from outside it. The same holds for anyone else on the network.

What protects it

Four conditions

  • Off until you switch it on

    One switch in settings, “Enable local MCP access.” Turning it off takes effect at once.

  • A local address only

    The server answers only apps on this Mac. It isn’t reachable from the network.

  • A token per client

    Name a token for each client and tick what it may do: read the library, read text, read highlights, export files, page images, edit, move to the trash, remove highlights. A new token starts with the three reading permissions ticked. The secret is shown once and the Keychain keeps only a fingerprint of it. Revoke a token in Settings → AI & MCP → MCP → Tokens and every client using it loses access at once; clients with other tokens keep working.

  • Deleting asks, where it can

    Only a token with “Move to trash” can delete, and only in editing mode. A client that can show a prompt asks you first; where it can’t, that permission is your consent in advance. A document goes to the tablet’s trash rather than vanishing. “Remove highlights” is a permission of its own: erased marks don’t come back from the trash, but the pages as they were stay on this Mac.

FAQ

Questions about access

Do I have to keep the app open?
With launch at login on, a background agent keeps it running — menu bar icon or not — until you quit it. If it isn’t running, the client can’t connect.

Try it on your own library

Free, no sign-up. Works with a reMarkable account — Connect isn’t required.

Download for MacFree · macOS 15+ · Release notes

On your phone? Save the link for your Mac.