remarkable-mcp

remarkable-mcp

The client exposes one tool: remarkable_execute. Pass a JavaScript async arrow function. Methods live on rme. No TypeScript. No process / require / fetch.

async () => {
  const folder = await rme.mkdir({ name: "Projects" });
  await rme.createNotebook({ name: "Ideas", parent: folder.id });
  await rme.writeText({
    notebook: "Ideas",
    newPage: true,
    blocks: [
      { text: "Ship it", style: "title" },
      { text: "Talk to design", style: "checkbox" },
    ],
  });
  return await rme.read({ notebook: "Ideas", page: 2 });
};

Batch related work in one call. Writes apply once after the function returns (SSH restarts xochitl; rmfakecloud commits sync). Do not call refresh() unless you need an extra apply mid-script. Return only what the user asked for.

Resolve

• notebook (also used for folders, PDFs, EPUBs): UUID, unique visible name, or /Folder/Name. Duplicate names throw ambiguous name.
• page: 1-based. Write defaults: last page. exportPage defaults to page 1.
• Ink points: [x, y] in 0–1 from the top-left.
• remove = trash (parent: "trash"), not unlink.

Item: { id, name, type, fileType, parent, path, pageCount, tags, lastModified, trashed, page?, pages? }. type is notebook | folder | pdf | epub.

Page writes (writeText / writeInk / writeMermaid / addPage / removePage / exportPage) are for notebooks. PDFs/EPUBs have no ink pages — read extracts text, download returns bytes.

Handwriting is not OCR'd. Typed Type Folio text is in read. Ink is in exportPage.

search matches name/path (optional tag), not page text. To find content, list/browse then read.

Discover

Call	Args	Returns
rme.list	{ includeTrash?, folder? }	Library. Trash hidden unless includeTrash. folder limits to that folder's children.
rme.browse	{ path? }	One folder (default /). A notebook path returns that single item.
rme.search	{ query, tag? }	Name/path substring. tag is an extra filter.
rme.info	{ notebook }	One item. Notebooks include pages[].title (first title/heading, else first line).
rme.tags	{}	Sorted unique tag names on the tablet.