# Supernote MCP server

> Lets an AI agent capture the screen, read handwritten notes, and manage files on a Ratta Supernote e-ink tablet over local Wi-Fi.

- Repository: https://github.com/ridget/supernote-mcp
- Page: https://hostedmcp.org/servers/ridget/supernote-mcp
- Transport: stdio
- Stars: 2
- License: MIT
- Latest version: 0.2.2

## Install

### Claude Code

```sh
claude mcp add supernote-mcp -- npx -y supernote-mcp
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

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

### VS Code CLI

```sh
code --add-mcp '{"name":"supernote-mcp","type":"stdio","command":"npx","args":["-y","supernote-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add supernote-mcp -- npx -y supernote-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

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

### Gemini CLI

```sh
gemini mcp add -s user supernote-mcp npx -- -y supernote-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SUPERNOTE_DISCOVER` | no | no | Set to 0 to disable the LAN-scan fallback used when SUPERNOTE_IP is unset or unreachable. |
| `SUPERNOTE_IP` | no | no | Device IP (optionally with :port) from the Supernote mirroring popup. Optional — if unset, the server scans the LAN for the mirror. |

## Tools (6)

- `supernote_snapshot`
- `supernote_list_files`
- `supernote_read_note`
- `supernote_render_note`
- `supernote_download_file`
- `supernote_upload_file`

## FAQ

### What hardware is required to use this server?

You need a Supernote device that supports Screen Mirroring, such as Manta, Nomad, A5X, or A6X-class devices.

### How do I handle the tablet's IP address changing?

You can pin the IP using a DHCP reservation on your router, or the server can automatically scan the local network for the device if the configured address is unreachable.

### Is this an official product from Supernote?

No, this is an unofficial, community-built project and is not affiliated with or endorsed by Ratta or Supernote.
