Claude MarketplacesSubmit
ridget avatar

Supernote

ridget/supernote-mcp

Gives your AI direct access to a Ratta Supernote e-ink tablet over Wi-Fi. Captures the live screen while you're sketching or handwriting, reads saved notebooks as recognized text or rendered page images, browses the file tree, and uploads PDFs or documents for annotation. Built on reverse-engineered LAN APIs (screen mirroring on port 8080, Browse & Access file server on 8089), so it's unofficial and could break with firmware updates. Useful when you want to pull handwritten notes straight into a conversation, have the agent summarize meeting scribbles, or push reference material to the device without leaving your terminal. Read-only except for uploads, with automatic network discovery if your tablet's DHCP lease changes.

tools
6
transport
STDIO
env vars
2
last updated
Jun 3, 2026
View on GitHub

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

supernote_snapshotGrabs the live screen as image/png via Screen Mirroring (port 8080).

Grabs the live screen as image/png via Screen Mirroring (port 8080).

No parameter schema in public metadata yet.

supernote_list_filesLists files and folders on the device via Browse & Access (port 8089), each with a path to pass on.

Lists files and folders on the device via Browse & Access (port 8089), each with a path to pass on.

No parameter schema in public metadata yet.

supernote_read_noteReturns a note's recognized handwriting/text per page.

Returns a note's recognized handwriting/text per page.

No parameter schema in public metadata yet.

supernote_render_noteReturns note pages as image/png (all pages, capped at 20, or chosen pages).

Returns note pages as image/png (all pages, capped at 20, or chosen pages).

No parameter schema in public metadata yet.

supernote_download_fileDownloads a file from the device to the local filesystem.

Downloads a file from the device to the local filesystem.

No parameter schema in public metadata yet.

supernote_upload_fileUploads a local file to the device; the only tool that writes to it.

Uploads a local file to the device; the only tool that writes to it.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

SUPERNOTE_IP

Device IP (optionally with :port) from the Supernote mirroring popup. Optional — if unset, the server scans the LAN for the mirror.

SUPERNOTE_DISCOVER

Set to 0 to disable the LAN-scan fallback used when SUPERNOTE_IP is unset or unreachable.

Readme

supernote-mcp

An MCP server for the Ratta Supernote e-ink tablet. It lets an AI agent see and work with your Supernote over the local Wi-Fi network:

  • Grab the live screen while you sketch or handwrite — "what did I just draw?"
  • Browse and read your saved notebooks — recognized handwriting as text, or pages as images.
  • Upload files to the device for you to read or annotate.
  • Download files from the device — retrieve annotated PDFs, exported notes, or any stored file.

The idea is collaborative prompting: handwrite on the tablet during a planning session and pull it straight into the conversation, or have the agent read and reason over notes you saved earlier.

Every tool is lazy — it touches the device only when invoked, so a session that never calls one makes no network calls to the tablet.

View the full README on GitHub

Details

Repository
github.com/ridget/supernote-mcp
Categories
AI & LLM Tools, Design & Creative
Package
supernote-mcp
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1rnwy avatarRNWY Trust Intelligencernwy/mcpCheck if an AI agent is trustworthy. Sybil detection, signed attestations, 150,000+ agents. Free.0stars
2rocnubie avatarAI Photo Editor MCProcnubie/aiphotoeditor-mcpBest AI Photo Editor powered by GPT Image 2, Flux, Nano Banana & more.0stars
3rocnubie avatarEarScribe MCProcnubie/earscribe-mcpEarScribe is a browser-based transcription tool that converts audio to text on-device using OpenAI0stars
4rocnubie avatarFlowMusicAI MCProcnubie/flowmusicai-mcpFlow Music AI is a free AI music generator that turns one prompt into a finished royalty-free track0stars
5rocnubie avatarFlux-2 Online MCProcnubie/flux-2-online-mcpFlux-2 Online is an online interface for the Flux 2 image generation model with prompt tuning and0stars
6rocnubie avatarZ-Image MCProcnubie/z-image-mcpZ-Image is an online interface for the Z-Image generation model with fast inference and prompt0stars