reMarkable API and MCP server Let your AI agent keep your reMarkable in order.

ToolWhat it doesAccess

• list_files List the files and folders in My files, at the top level or inside one folder. read

  Returns what the My files list shows for each entry: id, name, whether it is a file or a folder, its folder, file type and size. Entries come in the order My files shows them. It lists one folder level per call; call it again with a folder to go deeper. Any account can call it.

  MCP callremarkable_read → list_files

  REST endpointGET https://cotlet.dev/api/v1/remarkable/files

  Parameters

  Parameters: list_files

  Name	Type	Description
  folder string	string	Folder id or name. Leave out for the top level of My files.
  type enum	enum	all, files or folders. Default: all.

  Example response

  {
    "folder": "Reading",
    "items": [
      {
        "id": "f_8a1c20",
        "name": "Attention is all you need",
        "kind": "file",
        "file_type": "pdf",
        "size_mb": 2.1
      },
      {
        "id": "f_8a1c31",
        "name": "Deep Work",
        "kind": "file",
        "file_type": "epub",
        "size_mb": 1.4
      },
      {
        "id": "d_4b7e02",
        "name": "Archive",
        "kind": "folder"
      }
    ]
  }

• get_file Read one file or folder from My files by id. read

  Returns the entry as My files shows it: name, kind, file type, size and the folder it sits in. It does not return the pages or handwriting. Use it before a rename or a move to check you have the right file.

  MCP callremarkable_read → get_file

  REST endpointGET https://cotlet.dev/api/v1/remarkable/files/{file_id}

  Parameters

  Parameters: get_file

  Name	Type	Description
  file_id string required	string	Id from list_files.

  Example input

  {
    "file_id": "file_8c41d2"
  }

  Example response

  {
    "id": "f_8a1c20",
    "name": "Attention is all you need",
    "kind": "file",
    "file_type": "pdf",
    "size_mb": 2.1,
    "folder": "Reading"
  }

• import_file Import a PDF, EPUB, JPG or PNG into My files, so it syncs to your tablet. write

  Imports the file the way the Import button does. reMarkable accepts PDF, EPUB, JPG and PNG up to 100 MB per file, and turns JPG and PNG into PDF. The file appears in My files and on the tablet after it syncs. It reaches only your own library and is undone with trash_file, so it does not wait for your OK.

  MCP callremarkable_write → import_file

  REST endpointPOST https://cotlet.dev/api/v1/remarkable/files

  Parameters

  Parameters: import_file

  Name	Type	Description
  file string required	string	An https URL, or the id of a file sent with cotlet_upload_file.
  name string	string	Name to show in My files. Default: the file name.
  folder string	string	Folder id or name to move it into after the import. Default: top level.

  Example input

  {
    "file": "https://example.com/files/q4-board-deck.pdf",
    "name": "Q4 board deck",
    "folder": "Reading"
  }

  Example response

  {
    "id": "f_8a1c44",
    "name": "Q4 board deck",
    "kind": "file",
    "file_type": "pdf",
    "size_mb": 3.8,
    "folder": "Reading",
    "status": "imported"
  }

• rename_file Rename a file or folder in My files. write

  Renames the entry the way Rename does in My files. Nothing else changes, and the old name comes back with one more call, so it does not wait for your OK.

  MCP callremarkable_write → rename_file

  REST endpointPATCH https://cotlet.dev/api/v1/remarkable/files/{file_id}

  Parameters

  Parameters: rename_file

  Name	Type	Description
  file_id string required	string	Id from list_files.
  name string required	string	The new name.

  Example input

  {
    "file_id": "file_8c41d2",
    "name": "Jane Doe"
  }

  Example response

  {
    "id": "f_8a1c44",
    "name": "2026-10-24 Board deck Q4",
    "previous_name": "Q4 board deck",
    "status": "renamed"
  }

• move_file Move a file or folder to another folder in My files. write

  Moves the entry the way Move does in My files. The destination must exist; the call fails with the folder name you gave if it does not. The move reaches only your own library and goes back with one more call, so it does not wait for your OK.

  MCP callremarkable_write → move_file

  REST endpointPOST https://cotlet.dev/api/v1/remarkable/files/{file_id}/move

  Parameters

  Parameters: move_file

  Name	Type	Description
  file_id string required	string	Id from list_files.
  folder string required	string	Destination folder id or name.

  Example input

  {
    "file_id": "file_8c41d2",
    "folder": "folder"
  }

  Example response

  {
    "id": "f_8a1c44",
    "name": "2026-10-24 Board deck Q4",
    "folder": "Archive",
    "previous_folder": "Reading",
    "status": "moved"
  }

• trash_file Move a file or folder to the trash, as Move to trash does in My files. writeasks first

  Moves the entry to the trash and returns its id and name. It does not empty the trash. The file disappears from your tablet after the next sync, so confirming matters most for folders. By default you confirm each call; you can switch that off for this tool.

  MCP callremarkable_write → trash_file

  REST endpointPOST https://cotlet.dev/api/v1/remarkable/files/{file_id}/trash

  Parameters

  Parameters: trash_file

  Name	Type	Description
  file_id string required	string	Id from list_files.

  Example input

  {
    "file_id": "file_8c41d2"
  }

  Example response

  {
    "id": "f_8a1c31",
    "name": "Deep Work",
    "status": "trashed"
  }

ToolWhat it doesAccess

• get_account Read the name and email of the signed-in reMarkable account. read

  Returns the name and email that Account shows. It never returns the password or sign-in method. Use it to check which account your Cloud Browser is signed in to.

  MCP callremarkable_read → get_account

  REST endpointGET https://cotlet.dev/api/v1/remarkable/account

  Parameters

  No parameters.

  Example response

  {
    "name": "Maya Lopez",
    "email": "maya@example.com"
  }

• get_subscription Read the Connect subscription status and billing interval. read

  Returns what Subscription shows: whether Connect or a free trial is active and the billing interval, monthly or annual. Card details stay in reMarkable. It changes nothing.

  MCP callremarkable_read → get_subscription

  REST endpointGET https://cotlet.dev/api/v1/remarkable/subscription

  Parameters

  No parameters.

  Example response

  {
    "plan": "Connect",
    "status": "active",
    "billing_interval": "annual"
  }

• list_payments List your Connect payment history. read

  Returns the payment history that Account lets you view, newest first, with date and amount. It is read-only: it cannot change the plan or the card.

  MCP callremarkable_read → list_payments

  REST endpointGET https://cotlet.dev/api/v1/remarkable/payments

  Parameters

  Parameters: list_payments

  Name	Type	Description
  limit integer	integer	Most recent payments to return. Default: 10.

  Example response

  {
    "payments": [
      {
        "date": "2026-09-14",
        "amount": "39.90",
        "currency": "USD"
      },
      {
        "date": "2025-09-14",
        "amount": "39.90",
        "currency": "USD"
      }
    ]
  }