remarkable-mcp@2.1.0
CAUTION· not startedPublisher claims: "MCP server for accessing reMarkable tablet data" Observed in sandbox: no network, touches nothing outside the project, writes no memory.
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.
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 deviationsStatic findings
in 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.result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.uvx 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.assert 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.| 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.result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.client = 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.expected_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.in 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.| [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.Follow the official instructions to enable developer mode:Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.</instructions>Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.expected_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.| 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.assert middleware._validate_origin("http://192.0.2.10:3000") is TrueFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls."~/.ssh/remarkable",Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.</instructions>Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.SSH (requires developer mode):Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.<instructions>Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.Developer 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.SSH (requires developer mode):Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.monkeypatch.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.| [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.| 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.<instructions>Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.[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.<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.- **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.> ⚠️ **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.### 1. Enable Developer ModeFix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.client = 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.<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.2. **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.[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.process = subprocess.Popen(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.uvx 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.| 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.| 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.assert middleware._validate_origin("http://192.0.2.10:3000") is TrueFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.| 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.| [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.- **[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.| 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.It 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.| **Developer Mode** | ✅ Not needed | ❌ Required | ✅ Not needed |Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.> ⚠️ **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.### 1. Enable Developer ModeFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.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.host: 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.DEFAULT_USB_HOST = "http://10.11.99.1"Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.- 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.Default connection: http://10.11.99.1 (USB connection)Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.Follow the official instructions to enable developer mode:Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.- **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.Developer 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.- **[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.### 1. Enable Developer ModeFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.| **Developer Mode** | ✅ Not needed | ❌ Required | ✅ Not needed |Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.- **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.Follow the official instructions to enable developer mode:Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.It 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.Cost to the agent
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%- 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.
- 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.
- 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.
- Python subprocess execution detected≈ +2 on the totalBuild commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
- 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.
- HTTP URL with a raw public IP address≈ +2 on the totalReplace encoded or assembled strings with plain literals and remove undeclared network calls.