Supernote MCP Server

by ridget Your server? Claim it

local only

Supernote runs on your own machine — the client starts it, so there is no endpoint to ping. 45 installs a week from npm. Last commit 3 Jun 2026.

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

Installs per day peak 26 · avg 8 · -17% w/w

a month agotoday

Installs / week

npm · supernote-mcp

Stars

0 open issues

3 Jun 2026

Last commit

0 releases in 90 days

MIT

License

TypeScript

Nothing serious here today

Today is the operative word: we check Supernote every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add supernote-mcp -- npx -y supernote-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "supernote-mcp": {
      "args": [
        "-y",
        "supernote-mcp"
      ],
      "command": "npx"
    }
  }
}

~/.codex/config.toml

[mcp_servers.supernote-mcp]
command = "npx"
args = ["-y", "supernote-mcp"]

.cursor/mcp.json

{
  "mcpServers": {
    "supernote-mcp": {
      "args": [
        "-y",
        "supernote-mcp"
      ],
      "command": "npx"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "supernote-mcp": {
      "args": [
        "-y",
        "supernote-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: 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.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Supernote

same job, measured the same way

Genai Capture

by linhnnmt

Capture & annotate your screen from an AI agent: arrows, boxes, text, highlight, blur/redact.

27 installs/wk local only

Screenshotrender MCP

by faridmth

Capture website screenshots from any MCP client via the ScreenshotRender API.

25 installs/wk local only

Slimsnap

by bickov

Your recent screen captures as structured JSON your AI agent can read. Local only, no network.

42 installs/wk local only

Caliu Notes

by caliuapp

Read and write your Caliu notes from any MCP client: search, create, tag, remind, attach files.

622 installs/wk answering

Macos Vision MCP

by woladi

Local OCR & screen understanding for agents: read any window, find what to click. No uploads.

111 installs/wk local only

Super Log

by super-log

Query your local super-log bench from an AI agent - read-only log tools over the hub.

32 installs/wk local only

uploads.sh

by uploads

Host files from coding agents; stage on a branch and attach to GitHub PRs.

631 installs/wk answering

Store Builder

by vuluu2k

Design, fill with real store data, render and publish Store Builder pages from an AI agent.

10 667 installs/wk local only

Supernote — questions

Answers built from our own checks of this server.

Why is there no uptime for Supernote?

Supernote runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package supernote-mcp was installed 45 times last week.

How do I connect Supernote?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls supernote-mcp straight from npm; nothing to host, nothing to sign up for.

How many people use Supernote?

The npm package supernote-mcp was installed 45 times in the last week. Week over week that is -17%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Supernote open source?

Yes — it is published under the MIT licence, written in TypeScript and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.