Skills/PyPI/remarkable-mcp

remarkable-mcp@2.1.0

CAUTION· not started

Publisher claims: "MCP server for accessing reMarkable tablet data" Observed in sandbox: no network, touches nothing outside the project, writes no memory.

Registry PyPI (MCP server)Publisher sam-morrow · publishing for 287 daysInstalls 2,497Last detonated 51 min ago

Coverage

Not started: dependency install failed; the server itself was not observed.
Tested
the dependency install step · every file read, file written and host contacted by what ran
Not tested
server startup · the tool list · tool behavior

What this means for the label: Caution here covers what ran. The server's tools were not exercised with a real credential, so nothing about their behavior is asserted; the credential summary below says what to do with that.

Before you give it your token

It will ask for
GOOGLE_VISION_API_KEYREMARKABLE_SSH_PASSWORDREMARKABLE_TOKENConfiguration, not credentials: REMARKABLE_BACKGROUND_COLOR, REMARKABLE_CACHE_DIR, REMARKABLE_CACHE_MAX_BLOB, REMARKABLE_DEFER_RESTART, REMARKABLE_DISABLE_CACHE, REMARKABLE_DISABLE_CLOUD_FALLBACK, REMARKABLE_ENABLE_WRITE, REMARKABLE_LOCAL_DIR, REMARKABLE_MCP_HOST, REMARKABLE_MCP_PORT, REMARKABLE_OCR_BACKEND, REMARKABLE_READ_ONLY, REMARKABLE_RESTART_POLL_INTERVAL, REMARKABLE_RESTART_SETTLE, REMARKABLE_RESTART_TIMEOUT, REMARKABLE_RETRY_ATTEMPTS, REMARKABLE_RETRY_DELAY, REMARKABLE_ROOT_PATH, REMARKABLE_SKIP_CONFIRM, REMARKABLE_SSH_HOST, REMARKABLE_SSH_KEY, REMARKABLE_SSH_PORT, REMARKABLE_SSH_TRACE, REMARKABLE_SSH_USER, REMARKABLE_SYNC_WORKERS, REMARKABLE_USB_HOST, REMARKABLE_USB_MAX_CONCURRENCY, REMARKABLE_USB_TIMEOUT, REMARKABLE_USE_LOCAL_DIR, REMARKABLE_USE_SSH, REMARKABLE_USE_USB_WEB
Where it talks to
remarkable.com, remarkable.engineering, remarkable.guide (its own)
What the honeypot saw
no credential files read · no network
What we could not test
server startup · the tool list · tool behavior

Connect it with a scoped credential, under the guard. It asks for GOOGLE_VISION_API_KEY, REMARKABLE_SSH_PASSWORD, REMARKABLE_TOKEN and talks to remarkable.com, remarkable.engineering, remarkable.guide. Give the credential to the guard, not the server: the value never enters the server's environment and only travels to the host you bind. What the tools do with a real credential was not observed.

$vet-skills run --secrets GOOGLE_VISION_API_KEY=remarkable.com,REMARKABLE_SSH_PASSWORD=remarkable.com,REMARKABLE_TOKEN=remarkable.com -- uvx remarkable-mcp

Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.

Is [email protected] safe to install?

KillerSkills ran it in the KillerSkills honeypot sandbox (2 scenarios; not started: dependency install failed; the server itself was not observed) on 2026-11-15 and scored it 74/100 (Caution). It is not known to be malicious, but it has behaviour or code a security policy should decide on before install. Notable findings: Prompt injection; Access to sensitive file paths; Authorization escalation language. Summary: no network, touches nothing outside the project, writes no memory.

Behavior trace

Honeypot run · 0 s · 2 scenarios · 0 deviations
t+CategoryObserved action
0.0sprocessno install scripts in bundle
0.1sprocessdependency install exit 1 ·
0.1sclaimednot started: dependency install failed (exit 1); the server itself was not observed
0.1sprocessscript backend runs setup only
0.1sprocessno install scripts to re-run

Static findings

CRITICAL
Prompt injectionSKILL.md:33 · Prompt injection — known jailbreak technique referencein tablet Settings → Storage. No subscription or developer mode needed.Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
MEDIUM
Python subprocess execution detectedsmoke/run_smoke.py:313 · Python subprocess execution detectedresult = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
HIGH
Access to sensitive file pathsremarkable_mcp/cli.py:91 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesuvx remarkable-mcp --ssh --ssh-key ~/.ssh/id_ed25519Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
Access to sensitive file pathstest_server.py:5907 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesassert client.key_path == os.path.expanduser("~/.ssh/rm_key")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
LOW
Authorization escalation languageREADME.md:285 · Authorization escalation language · informational: not an instruction file| SSH | Developer mode | No | Yes | Yes | PDF and EPUB | Yes | Yes |Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
MEDIUM
Python subprocess execution detectedtest_server.py:6455 · Python subprocess execution detectedresult = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
MEDIUM
References a credential file in the home directorytest_server.py:5752 · References a credential file in the home directoryclient = SSHClient(key_path="~/.ssh/id_ed25519")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST03
MEDIUM
Access to sensitive file pathstest_server.py:5756 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesexpected_key = os.path.expanduser("~/.ssh/id_ed25519")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Authorization escalation languageSKILL.md:33 · Authorization escalation languagein tablet Settings → Storage. No subscription or developer mode needed.Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Context shift attemptREADME.md:880 · Context shift attempt — trying to change operational mode · informational: not an instruction file| [SSH Setup](docs/ssh-setup.md) | Enable developer mode and configure SSH |Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectiondocs/ssh-setup.md:18 · Prompt injection — known jailbreak technique reference · informational: not an instruction fileFollow the official instructions to enable developer mode:Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
LOW
Fake instruction boundary tagdocs/development.md:134 · Fake instruction boundary tag · informational: not an instruction file</instructions>Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
MEDIUM
References a credential file in the home directorytest_server.py:5756 · References a credential file in the home directoryexpected_key = os.path.expanduser("~/.ssh/id_ed25519")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST03
LOW
Prompt injectionREADME.md:285 · Prompt injection — known jailbreak technique reference · informational: not an instruction file| SSH | Developer mode | No | Yes | Yes | PDF and EPUB | Yes | Yes |Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
MEDIUM
HTTP URL with a raw public IP addresstest_server.py:6649 · HTTP URL with a raw public IP address — a hard-coded destination that domain-based monitoring cannot nameassert middleware._validate_origin("http://192.0.2.10:3000") is TrueFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
MEDIUM
Access to sensitive file pathstest_server.py:6680 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files"~/.ssh/remarkable",Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
Python subprocess execution detectedremarkable_mcp/ssh.py:245 · Python subprocess execution detectedresult = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
LOW
Fake instruction boundary tag.github/copilot-instructions.md:171 · Fake instruction boundary tag · informational: not an instruction file</instructions>Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
HIGH
Authorization escalation languageSKILL.md:37 · Authorization escalation languageSSH (requires developer mode):Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Fake instruction boundary tag.github/copilot-instructions.md:169 · Fake instruction boundary tag · informational: not an instruction file<instructions>Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectiondocs/ssh-setup.md:14 · Prompt injection — known jailbreak technique reference · informational: not an instruction fileDeveloper mode is required to enable SSH access on your reMarkable.Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
CRITICAL
Prompt injectionSKILL.md:37 · Prompt injection — known jailbreak technique referenceSSH (requires developer mode):Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
MEDIUM
Access to sensitive file pathstest_server.py:5904 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesmonkeypatch.setenv("REMARKABLE_SSH_KEY", "~/.ssh/rm_key")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
LOW
Authorization escalation languageREADME.md:880 · Authorization escalation language · informational: not an instruction file| [SSH Setup](docs/ssh-setup.md) | Enable developer mode and configure SSH |Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectionREADME.md:67 · Prompt injection — known jailbreak technique reference · informational: not an instruction file| 1 | USB web | Connect the tablet and enable USB web | Upload; destination chosen by tablet | You want the shortest setup without a subscription or developer mode |Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
LOW
Fake instruction boundary tagdocs/development.md:132 · Fake instruction boundary tag · informational: not an instruction file<instructions>Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Authorization escalation languageREADME.md:236 · Authorization escalation language · informational: not an instruction file[developer mode](docs/ssh-setup.md), which factory-resets the tablet when enabled.Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
HIGH
Collapsed <details> block carrying instructionsREADME.md:575 · Collapsed <details> block carrying instructions<summary>Google Cloud Vision</summary> 1. Enable [Cloud Vision API](https://console.cloud.google.com/apis/library/vision.googleapis.com) 2. Create an [API key](Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Fake instruction boundary tagdocs/development.md:113 · Fake instruction boundary tag · informational: not an instruction file- **XML-structured docstrings**: use `<usecase>`, `<instructions>`, `<parameters>`, and `<examples>`Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectiondocs/ssh-setup.md:16 · Prompt injection — known jailbreak technique reference · informational: not an instruction file> ⚠️ **Warning:** Enabling developer mode will **factory reset** your device. Make sure your documents are synced to the cloud before proceeding.Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
LOW
Prompt injectiondocs/ssh-setup.md:12 · Prompt injection — known jailbreak technique reference · informational: not an instruction file### 1. Enable Developer ModeFix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
MEDIUM
Access to sensitive file pathstest_server.py:5752 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesclient = SSHClient(key_path="~/.ssh/id_ed25519")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Collapsed <details> block carrying instructionsREADME.md:115 · Collapsed <details> block carrying instructions<summary>Local directory configuration</summary> Add to `.vscode/mcp.json`: ```json { "servers": { "remarkable": { "command": "uvx", "args": ["remarkable-mcp", Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Fake instruction boundary tag.github/copilot-instructions.md:158 · Fake instruction boundary tag · informational: not an instruction file2. **XML-structured docstrings** - Use `<usecase>`, `<instructions>`, `<parameters>`, `<examples>` tagsFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectionREADME.md:236 · Prompt injection — known jailbreak technique reference · informational: not an instruction file[developer mode](docs/ssh-setup.md), which factory-resets the tablet when enabled.Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
MEDIUM
Python subprocess execution detectedremarkable_mcp/ssh.py:536 · Python subprocess execution detectedprocess = subprocess.Popen(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
AST05
HIGH
References a credential file in the home directoryremarkable_mcp/cli.py:91 · References a credential file in the home directoryuvx remarkable-mcp --ssh --ssh-key ~/.ssh/id_ed25519Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST03
LOW
Authorization escalation languageREADME.md:67 · Authorization escalation language · informational: not an instruction file| 1 | USB web | Connect the tablet and enable USB web | Upload; destination chosen by tablet | You want the shortest setup without a subscription or developer mode |Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectionREADME.md:70 · Prompt injection — known jailbreak technique reference · informational: not an instruction file| 4 | SSH | Enable developer mode and configure SSH | Full management and native authoring | You need direct filesystem access or native ink writes |Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
MEDIUM
URL using a raw public IP addresstest_server.py:6649 · URL using a raw public IP address — may bypass domain-based filteringassert middleware._validate_origin("http://192.0.2.10:3000") is TrueFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
LOW
Context shift attemptREADME.md:70 · Context shift attempt — trying to change operational mode · informational: not an instruction file| 4 | SSH | Enable developer mode and configure SSH | Full management and native authoring | You need direct filesystem access or native ink writes |Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectionREADME.md:880 · Prompt injection — known jailbreak technique reference · informational: not an instruction file| [SSH Setup](docs/ssh-setup.md) | Enable developer mode and configure SSH |Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
LOW
Prompt injectiondocs/ssh-setup.md:20 · Prompt injection — known jailbreak technique reference · informational: not an instruction file- **[Official reMarkable Support: Developer Mode](https://support.remarkable.com/s/article/Developer-mode)** — Official guide from reMarkableFix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
LOW
Authorization escalation languageREADME.md:70 · Authorization escalation language · informational: not an instruction file| 4 | SSH | Enable developer mode and configure SSH | Full management and native authoring | You need direct filesystem access or native ink writes |Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectiondocs/usb-web-setup.md:9 · Prompt injection — known jailbreak technique reference · informational: not an instruction fileIt does not require a Connect subscription or developer mode.Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
LOW
Prompt injectiondocs/usb-web-setup.md:139 · Prompt injection — known jailbreak technique reference · informational: not an instruction file| **Developer Mode** | ✅ Not needed | ❌ Required | ✅ Not needed |Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
LOW
Authorization escalation languagedocs/ssh-setup.md:16 · Authorization escalation language · informational: not an instruction file> ⚠️ **Warning:** Enabling developer mode will **factory reset** your device. Make sure your documents are synced to the cloud before proceeding.Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Context shift attemptdocs/ssh-setup.md:12 · Context shift attempt — trying to change operational mode · informational: not an instruction file### 1. Enable Developer ModeFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
URL to a private-network addressremarkable_mcp/cli.py:94 · URL to a private-network address — a LAN or development targetREMARKABLE_USB_HOST USB web interface host (default: http://10.11.99.1)Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
LOW
URL to a private-network addressremarkable_mcp/usb_web.py:118 · URL to a private-network address — a LAN or development targethost: Base URL for the USB web interface (default: http://10.11.99.1)Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
LOW
URL to a private-network addressremarkable_mcp/usb_web.py:40 · URL to a private-network address — a LAN or development targetDEFAULT_USB_HOST = "http://10.11.99.1"Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
LOW
URL to a private-network addressremarkable_mcp/usb_web.py:465 · URL to a private-network address — a LAN or development target- REMARKABLE_USB_HOST: USB web interface host (default: http://10.11.99.1)Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
LOW
URL to a private-network addressremarkable_mcp/usb_web.py:7 · URL to a private-network address — a LAN or development targetDefault connection: http://10.11.99.1 (USB connection)Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
LOW
Authorization escalation languagedocs/ssh-setup.md:18 · Authorization escalation language · informational: not an instruction fileFollow the official instructions to enable developer mode:Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Prompt injectiondocs/usb-web-setup.md:149 · Prompt injection — known jailbreak technique reference · informational: not an instruction file- **Advanced users:** SSH — Fastest, but requires developer mode enabledFix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.
AST01
LOW
Authorization escalation languagedocs/ssh-setup.md:14 · Authorization escalation language · informational: not an instruction fileDeveloper mode is required to enable SSH access on your reMarkable.Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Authorization escalation languagedocs/ssh-setup.md:20 · Authorization escalation language · informational: not an instruction file- **[Official reMarkable Support: Developer Mode](https://support.remarkable.com/s/article/Developer-mode)** — Official guide from reMarkableFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Authorization escalation languagedocs/ssh-setup.md:12 · Authorization escalation language · informational: not an instruction file### 1. Enable Developer ModeFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Authorization escalation languagedocs/usb-web-setup.md:139 · Authorization escalation language · informational: not an instruction file| **Developer Mode** | ✅ Not needed | ❌ Required | ✅ Not needed |Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Authorization escalation languagedocs/usb-web-setup.md:149 · Authorization escalation language · informational: not an instruction file- **Advanced users:** SSH — Fastest, but requires developer mode enabledFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Context shift attemptdocs/ssh-setup.md:18 · Context shift attempt — trying to change operational mode · informational: not an instruction fileFollow the official instructions to enable developer mode:Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
Authorization escalation languagedocs/usb-web-setup.md:9 · Authorization escalation language · informational: not an instruction fileIt does not require a Connect subscription or developer mode.Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01

Cost to the agent

Instructions loaded
≈2,409 tok
2 files · 58 in bundle
Tool list per prompt
≈0 tok
0 tools · 0 per tool
Handshake
no reply
launch to tools/list, stdio
Undocumented tools
0
description under 20 chars · avg 0

Tokens estimated at four characters each. The tool list is re-read by the agent on every turn, so it is the number to compare between servers that do the same job: ranked across the index.

Known vulnerabilities

Not checked against OSV yet; the weekly check has not reached this version.

What would make this Verified

6 points to 80 · weights: behavior 45%, static 25%, prompt 15%, publisher 15%
  1. Unclaimed publisher≈ +8 on the totalClaim sam-morrow: a verified publisher gets +50 on publisher trust. It is free and usually instant with GitHub sign-in.
  2. Hidden instructions≈ +6 on the totalRemove HTML comments, zero-width characters and white-on-white text that carry instructions. Everything the agent is meant to read should be visible to the person reading the file.
  3. Access to sensitive file paths≈ +4 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
  4. Python subprocess execution detected≈ +2 on the totalBuild commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
  5. References a credential file in the home directory≈ +2 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
  6. HTTP URL with a raw public IP address≈ +2 on the totalReplace encoded or assembled strings with plain literals and remove undeclared network calls.
Publish a new version to PyPI, then queue it here. Not your skill? Claim the handle to get verdict changes by email.Claim sam-morrowPropose a patch to the maintainer