Guide

How to connect your reMarkable to Raycast

Raycast AI can install MCP servers, and remarkdown is one. Install it once and anything you ask Raycast AI can end up on your reMarkable as a notebook you write on with the pen. On Pro, Raycast can also read your handwritten pages back. There is no reMarkable extension in the Raycast store; this is how you get the same thing today. Three minutes, one form.

Connect your reMarkable tablet

Before you start

What you need


How the connection works

Sixty seconds on what you're setting up

Raycast talks to local MCP servers, programs it starts on your Mac. remarkdown is a hosted server, so the form below starts a tiny local bridge called mcp-remote that forwards Raycast's calls to https://mcp.remarkdown.org/mcp and handles the sign-in. Nothing is installed permanently; npx fetches the bridge when Raycast starts it. remarkdown then talks to the reMarkable cloud with a device token your tablet issued.

Three things follow from that:


Step 1

Pair your tablet with remarkdown

  1. Create a remarkdown account.
  2. Open my.remarkable.com/device/browser/connect and sign in with your reMarkable account. It shows a one-time code.
  3. Paste the code into remarkdown. We trade it for a per-device token, encrypt that, and throw the code away.

That's the tablet side, done permanently. Everything after this happens inside Raycast.


Step 2

Install remarkdown as an MCP server in Raycast

Short version: the Raycast tab on /connect

  1. Open Raycast and type “install”. Pick Install Server from the MCP extension.

    Raycast search showing the Install Server command from the MCP extension
    Type “install” and choose Install Server (MCP).
  2. Fill the form with exactly these three values. Copy each one; a stray space breaks it.

    Name

    Command

    Arguments

    Leave Icon on MCP, Environment empty, and Description blank or whatever you like. Press Cmd+Enter to install.

    Raycast's Install MCP Server form with name remarkdown, command npx, and the mcp-remote arguments
    Name, command, arguments. Everything else stays as it is.
  3. A browser window opens on remarkdown. Sign in if asked, then approve the consent screen. It lists exactly what Raycast gets: read documents, push markdown. Click Authorize and go back to Raycast. The requester shows as “MCP CLI Proxy”; that's the mcp-remote bridge acting for Raycast.

    remarkdown consent screen listing the two permissions, read documents and push markdown
    Two permissions, nothing else. Deny closes the window and nothing is connected.

The Arguments line is the whole configuration. Nothing else to edit, no JSON file.


Step 3

Send your first note

Open Raycast AI (the Ask AI command or Tab from the search bar) and type:

Raycast calls remarkdown, which converts the text and uploads it. It lands in your connected folder as a real reMarkable notebook, not a flat PDF, so you can write between the lines and file it like anything else on the tablet.

Two more that fit Raycast's quick-fire style:

If Raycast asks which tool to use, pick remarkdown. If the note isn't on the tablet yet, the tablet hasn't synced; put it on Wi-Fi and give it a moment.


The other direction

Your handwriting, back in Raycast

Your first few pushes are a trial, so you can see it on your own tablet. After that remarkdown is Pro at $9/month: unlimited pushes, plus Raycast reading your notebooks back with Document Reading turned on.

Once that's on, your notebooks are documents Raycast AI can open:

Handwritten pages reach Raycast as page images it reads directly. If you want the ink searchable by text later, transcription is a separate step that runs on credits and never alters the original ink.


When it doesn't work

The four things that actually go wrong

The server shows an error right after install

Open Raycast's MCP extension, Manage Servers, remove remarkdown, and install it again with the three values above copied exactly. A stray space in the Arguments line is the usual cause.

The sign-in window never opened

mcp-remote opens it on first use, not always on install. Ask Raycast AI anything that mentions remarkdown; the browser tab appears then. If it still doesn't, remove the server in Raycast's MCP extension (Manage Servers) and install it again.

The note never showed up on the tablet

Almost always the tablet hasn't synced. Put it on Wi-Fi and wait. Then look inside your connected folder, not the top level. If Raycast reported an error rather than a success, the push didn't happen; your remarkdown dashboard's activity log will say so.

Raycast can't read a notebook back

Reading needs Pro with Document Reading switched on, and the document has to sit inside your connected folder, subfolders included. If the notebook is elsewhere, move it in, or change the connected folder on your dashboard.

Still stuck? support@remarkdown.org. We answer.


What we can see

Privacy, briefly

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. The mcp-remote bridge runs on your Mac and keeps its sign-in token there; we never see your reMarkable password. No ads, nothing sold. You pay for Pro, that's the business.


FAQ

Questions people ask

Is there a reMarkable extension for Raycast?
Not in the Raycast store. This MCP server is the way to get reMarkable into Raycast AI today, and it does more than a typical extension: it sends and reads notes, not just opens the app.
Do I need to pay remarkdown for this?
Not for the trial. Pairing and your first few pushes need no plan. After that remarkdown is Pro at $9/month: unlimited pushes and Raycast reading your notebooks back, handwriting included.
Do I need Raycast Pro?
You need Raycast AI, which is what runs MCP servers. Check Raycast's own pricing for which plan includes it.
What is mcp-remote and why is it in the command?
Raycast only starts local MCP servers. mcp-remote is a small open-source bridge that runs locally and forwards to our hosted server, including the OAuth sign-in. That's why the consent screen names "MCP CLI Proxy".
Does this install anything on my tablet?
No. Everything goes through reMarkable's own cloud sync. Unpair and the tablet is exactly as it was.
Which reMarkable models work?
reMarkable 1, reMarkable 2, and Paper Pro.
Can I use the same account in Claude, ChatGPT, Cursor, or Notion?
Yes. Same account, same URL. Each client has its own setup page.
Is this official?
No. remarkdown is an independent product from Remarkdown LLC, not affiliated with reMarkable AS or Raycast.

Pair once. After that it's just asking.

Connect your reMarkable tablet