Supernote

Official

by ridget · TypeScript

Capture the screen, read/render notes, and upload files on a Ratta Supernote from an AI agent.

io.github.ridget/supernote-mcp — Model Context Protocol (MCP) Server

This MCP server enables an AI agent to interact with a Ratta Supernote by capturing the device screen, reading and rendering notes, and uploading files. It is designed to support these note and file workflows through the MCP interface.

🛠️ Key Features

Capture the screen from a Ratta Supernote
Read notes from the device
Render notes
Upload files to the device

🚀 Use Cases

Let an AI agent view the current state of the Supernote screen
Assist with extracting and using existing notes
Transfer documents or attachments to the Supernote via uploads

⚡ Developer Benefits

Provides a standardized MCP server interface for Supernote screen, note, and file operations

⚠️ Limitations

Only described capabilities are screen capture, note read/render, and file upload; no other functions are specified

Install

Configuration

Environment variables

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.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "supernote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supernote-mcp@0.2.2"
      ],
      "env": {
        "SUPERNOTE_IP": "<YOUR_SUPERNOTE_IP>",
        "SUPERNOTE_DISCOVER": "<YOUR_SUPERNOTE_DISCOVER>"
      }
    }
  }
}