What is supernote-mcp?
supernote-mcp, from the GitHub user ridget, connects an MCP client to a Ratta Supernote e-ink tablet on the same Wi-Fi network. It grabs the live screen while you write, lists files, returns a notebook's recognised handwriting as text or its pages as images, and copies files to and from the tablet. It uses two features the tablet already has: Screen Mirroring on port 8080 and the Browse & Access file server on port 8089.
It is MIT-licensed TypeScript, published to npm and as standalone binaries for five platforms, and has about 2 GitHub stars. Version 0.2.3, released on 22 September 2026, added the download tool. It is not affiliated with Ratta.
How to install supernote-mcp
npx -y supernote-mcpIs supernote-mcp worth it?
supernote-mcp does six things and does them plainly. supernote_snapshot returns the current screen as a PNG, the list, read and render tools work through saved notebooks, and upload and download move files. Reading a note returns the tablet's own handwriting recognition as text, which costs a model far less than images; rendering caps at 20 pages per call. Every tool times out after 10 seconds with a message naming the likely cause, and none touches the tablet until it is called.
Both interfaces it relies on were reverse-engineered, and the README says so: the screen mirror and Browse & Access are not documented for programs, and a firmware update could change or break them. Ratta's support page describes Browse & Access as a file server you open in a browser on the same Wi-Fi, and neither it nor the README mentions a password or PIN. Nothing in either suggests the tablet limits who connects, so while a toggle is on, treat its screen or files as open to anyone on that network.
The catch: the agent gets file access in both directions. supernote_upload_file sends any local file the server process can read, and supernote_download_file writes to a local path, $TMPDIR by default. If the configured address fails, the server scans your whole subnet on port 8080 to find the tablet; on an office network that scan may itself trip an alarm, and SUPERNOTE_DISCOVER=0 turns it off. A VPN or proxy on the computer breaks the connection.
Our take: for a Supernote owner who plans on paper and wants the sketch in the chat without exporting it, this is the shortest path, and setup is two toggles and an IP address. Switch the tablet's features on only for the session, and expect gaps after major firmware updates while the single developer catches up.
Where it earns its place
A product manager who sketches flows on a Supernote Manta in meetings
Turn this afternoon's sketch into a written spec
Turn on Screen Mirroring, ask the agent to snapshot the screen, and have it draft the spec from the image. Free; each snapshot is one image in the model's context.
A graduate student with a semester of lecture notes on a Nomad
Summarise my notes on one topic before an exam
Open Browse & Access, have the agent list /Note, then read the relevant notebooks as text with supernote_read_note. Notes without recognised text fall back to rendered pages, up to 20 per call.
A lawyer who annotates PDFs on the tablet
Send a draft to my Supernote and pull back the marked-up copy
Upload the PDF with supernote_upload_file, annotate on the device, then fetch it with supernote_download_file. Keep Browse & Access off on shared office Wi-Fi when it is not in use.
Before you commit
- Setup
- Turn on Screen Mirroring or Browse & Access on the tablet and note its IP address, then run claude mcp add with SUPERNOTE_IP set and npx -y supernote-mcp. Needs Node.js 18+, Bun or the standalone binary; a DHCP reservation keeps the IP stable.
- Integrations
- Supernote devices with Screen Mirroring (Manta, Nomad, A5X and A6X class). Built on the supernote-typescript library for frame capture and .note parsing. Any MCP client over stdio.
- Data and privacy
- Runs locally over stdio. Screen images, note text and file contents go to your model provider. The tablet's mirror (port 8080) and file server (port 8089) are reachable on the local network while switched on. Uploads read any local file the server can access.
- Cost at scale
- Free under MIT. The tablet is the only cost.
- Limits
- Same Wi-Fi network and no VPN or proxy. Undocumented interfaces may break with firmware updates. Renders cap at 20 pages; calls time out after 10 seconds.
What’s good
- Reads recognised handwriting as text, not just images
- 10-second timeouts with clear failure messages
- npm, Bun and standalone binary installs
- Touches the tablet only when a tool is called
What’s not
- Relies on reverse-engineered, undocumented interfaces
- Tablet's mirror and file server ask for no password
- Fallback discovery scans the whole subnet
- Single developer with about 2 stars
Best for
Supernote Manta, Nomad, A5X or A6X owners who handwrite during planning or meetings and want an agent to read those pages.
supernote-mcp: common questions
- Is supernote-mcp worth it?
- A tidy, narrow bridge that makes handwriting on a Supernote useful in an agent conversation, resting on undocumented interfaces the next firmware update could change. We rate it 3.6 out of 5.
- How much does supernote-mcp cost?
- Free and open source (MIT). Needs a Supernote with Screen Mirroring or Browse & Access.
- What are the downsides of supernote-mcp?
- Relies on reverse-engineered, undocumented interfaces; tablet's mirror and file server ask for no password; fallback discovery scans the whole subnet; single developer with about 2 stars.
- Who is supernote-mcp best for?
- Supernote Manta, Nomad, A5X or A6X owners who handwrite during planning or meetings and want an agent to read those pages.
- How much does supernote-mcp cost for a team or in production?
- Free under MIT. The tablet is the only cost.
- Is supernote-mcp safe for company data?
- Runs locally over stdio. Screen images, note text and file contents go to your model provider. The tablet's mirror (port 8080) and file server (port 8089) are reachable on the local network while switched on. Uploads read any local file the server can access.
Answers checked Nov 14, 2026.