How do I install the Supernote skill?

Run npx skillmds@latest add modbender/supernote in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Supernote safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Supernote?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Supernote free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Supernote?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Supernote by modbender — Agent Skill

Name: Supernote
Rating: 4.2 (5 reviews)
Author: modbender

Supernote

Access a self-hosted Supernote Private Cloud instance to browse files and folders, upload documents (PDF, EPUB) and notes, convert web articles to EPUB/PDF and send them to the device, check storage capacity, and navigate the directory tree. Use when the user mentions Supernote, e-ink device files, wants to upload/browse documents on their Supernote cloud, or wants to send an article/URL to their e-reader.

modbender Updated Sep 9, 2026 12 repo stars

File contents

Supernote Private Cloud

Browse, upload, and manage files on a self-hosted Supernote Private Cloud via its reverse-engineered REST API. Includes article-to-ebook conversion for sending web content to the device.

Setup

export SUPERNOTE_URL="http://192.168.50.168:8080"
export SUPERNOTE_USER="your@email.com"
export SUPERNOTE_PASSWORD="your_password"

Python dependencies (for article conversion): readability-lxml, ebooklib, requests, beautifulsoup4, lxml.

Commands

Send a web article to the device

{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format epub --dir-path Document
{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format pdf --dir-path "Document/Articles"
{baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --title "Custom Title" --dir-path Document

Fetches article content, extracts readable text with images, converts to clean EPUB or PDF, then uploads to the specified folder. Default format: epub. Default folder: Document.

List directory contents

{baseDir}/scripts/supernote.sh ls
{baseDir}/scripts/supernote.sh ls --path Document
{baseDir}/scripts/supernote.sh ls --path "Note/Journal"
{baseDir}/scripts/supernote.sh ls --dir 778507258886619136

Directory tree

{baseDir}/scripts/supernote.sh tree --depth 2

Find directory ID by path

{baseDir}/scripts/supernote.sh find-dir --path "Document/Books"

Upload a file

{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir-path Document
{baseDir}/scripts/supernote.sh upload --file /path/to/book.epub --dir-path "Document/Books"
{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir 778507258773372928 --name "Renamed.pdf"

Check storage capacity

{baseDir}/scripts/supernote.sh capacity

Login (manual)

{baseDir}/scripts/supernote.sh login

Default Folders

Folder	Purpose
Note	Handwritten notes (.note files)
Document	PDFs, EPUBs, documents
Inbox	Incoming files
Export	Exported content
Screenshot	Screenshots
Mystyle	Custom styles/templates

Notes

EPUB is recommended for articles — renders cleanly on e-ink with reflowable text
The API is reverse-engineered and unofficial — endpoints may change with firmware updates
Directory args accept paths (e.g., "Document/Books") or numeric IDs
Some sites block scraping — if fetch fails, try a different URL or use a cached/saved page

---name: supernotedescription: Access a self-hosted Supernote Private Cloud instance to browse files and folders, upload documents (PDF, EPUB) and notes, convert web articles to EPUB/PDF and send them to the device, check storage capacity, and navigate the directory tree. Use when the user mentions Supernote, e-ink device files, wants to upload/browse documents on their Supernote cloud, or wants to send an article/URL to their e-reader.--- # Supernote Private Cloud Browse, upload, and manage files on a self-hosted Supernote Private Cloud via its reverse-engineered REST API. Includes article-to-ebook conversion for sending web content to the device. ## Setup ```bash export SUPERNOTE_URL="http://192.168.50.168:8080" export SUPERNOTE_USER="your@email.com" export SUPERNOTE_PASSWORD="your_password" ``` Python dependencies (for article conversion): `readability-lxml`, `ebooklib`, `requests`, `beautifulsoup4`, `lxml`. ## Commands ### Send a web article to the device ```bash {baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format epub --dir-path Document {baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --format pdf --dir-path "Document/Articles" {baseDir}/scripts/supernote.sh send-article --url "https://example.com/article" --title "Custom Title" --dir-path Document ``` Fetches article content, extracts readable text with images, converts to clean EPUB or PDF, then uploads to the specified folder. Default format: epub. Default folder: Document. ### List directory contents ```bash {baseDir}/scripts/supernote.sh ls {baseDir}/scripts/supernote.sh ls --path Document {baseDir}/scripts/supernote.sh ls --path "Note/Journal" {baseDir}/scripts/supernote.sh ls --dir 778507258886619136 ``` ### Directory tree ```bash {baseDir}/scripts/supernote.sh tree --depth 2 ``` ### Find directory ID by path ```bash {baseDir}/scripts/supernote.sh find-dir --path "Document/Books" ``` ### Upload a file ```bash {baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir-path Document {baseDir}/scripts/supernote.sh upload --file /path/to/book.epub --dir-path "Document/Books" {baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir 778507258773372928 --name "Renamed.pdf" ``` ### Check storage capacity ```bash {baseDir}/scripts/supernote.sh capacity ``` ### Login (manual) ```bash {baseDir}/scripts/supernote.sh login ``` ## Default Folders | Folder | Purpose | |--------|---------| | Note | Handwritten notes (.note files) | | Document | PDFs, EPUBs, documents | | Inbox | Incoming files | | Export | Exported content | | Screenshot | Screenshots | | Mystyle | Custom styles/templates | ## Notes - EPUB is recommended for articles — renders cleanly on e-ink with reflowable text - The API is reverse-engineered and unofficial — endpoints may change with firmware updates - Directory args accept paths (e.g., "Document/Books") or numeric IDs - Some sites block scraping — if fetch fails, try a different URL or use a cached/saved page

Frequently asked questions