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. 79 installs a week from npm. Last commit 22 Sep 2026.

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

Installs per day peak 150 · avg 13 · -72% w/w

a month agotoday

Installs / week

npm · supernote-mcp

Stars

0 open issues

22 Sep 2026

Last commit

1 release 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": {
      "command": "npx",
      "args": [
        "-y",
        "supernote-mcp"
      ]
    }
  }
}

~/.codex/config.toml

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

.cursor/mcp.json

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

.vscode/mcp.json

{
  "servers": {
    "supernote-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "supernote-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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).

Alternatives to Supernote

same job, measured the same way

Notion Large File Upload

by shoubhiksaha

Upload local files up to 5 GB to Notion and attach them to pages, read from disk, not the chat.

326 installs/wk local only

Genai Capture

by linhnnmt

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

59 installs/wk local only

Screenshotrender MCP

by faridmth

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

36 installs/wk local only

Slimsnap

by bickov

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

40 installs/wk local only

Cherry Notes

by cherrynotes

Tasks that outlive the chat. Capture features and tasks on your phone; your AI agent picks them up.

answering

Caliu Notes

by caliuapp

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

169 installs/wk answering

Macos Vision MCP

by woladi

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

97 installs/wk local only

Shotkiln

by shotkiln

Screenshot, PDF and Open Graph image API for AI agents: capture pages, render PDFs, make OG images.

3 tools answering

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 79 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 in the form 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 79 times in the last week. Week over week that is -72%. 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 2 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.