io.github.ridget/supernote-mcp

Official

by ridget · TypeScript

Supernote

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

Capture screens, render notes, and upload files on Ratta Supernote devices.

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.

claude_desktop_config.json

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