适合谁
- reMarkable 用户希望在 AI 工作流中利用设备上的笔记和文档。
- 需要在无设备连接时访问库的远程或无人值守场景（云端模式）。
- 希望通过 USB 快速离线访问且无需订阅的用户（USB Web 模式）。
R
65FMRS · C
该服务器为在 AI 工作流中利用 reMarkable 笔记提供了强大且灵活的集成。它支持多种连接模式，具有全面的读写工具，并提供智能功能如自动 OCR 和标签过滤。活跃的开发和清晰的文档增加了其可用性。
reMarkable MCP Server 让 AI 助手能够访问 reMarkable 平板上的全部笔记和文档。它支持浏览文件夹、搜索文档、读取任何文件，包括从手写笔记中提取文字（OCR）。提供多种连接方式：USB Web 接口（推荐，无需订阅和开发者模式）、SSH（需要开发者模式）以及云端（需要 Connect 订阅，无设备也可用）。内置写入工具（上传、创建文件夹、移动、重命名、删除），支持通过 MCP 资源访问文档文本和页面图像。
工具能力
remarkable_read
读取并提取文档文本（支持分页和搜索）。
remarkable_browse
浏览文件夹、按文档名搜索或按标签过滤。
remarkable_search
跨多个文档搜索内容（支持标签过滤）。
remarkable_recent
获取最近修改的文档。
remarkable_status
检查连接状态和各传输模式的能力矩阵。
remarkable_image
获取页面 PNG/SVG 图像（支持通过采样进行 OCR）。
remarkable_upload
上传 PDF 或 EPUB 文件到 reMarkable。
remarkable_mkdir
创建新文件夹（云端和 SSH 模式）。
remarkable_move
移动文档或文件夹（云端和 SSH 模式）。
remarkable_rename
重命名文档或文件夹（云端和 SSH 模式）。
remarkable_delete
删除文档或文件夹——具有破坏性（云端和 SSH 模式）。
remarkable_author
创建原生墨迹和笔记本（仅 SSH 模式）。
remarkable_canvas
在交互式画布中打开页面查看器。
安装接入
- 确保已安装 Python 和 uvx。2. 选择连接模式：USB Web（推荐）——在平板设置→存储中启用“USB web 接口”；SSH——启用开发者模式；云端——在 my.remarkable.com 获取一次性代码，然后用
uvx remarkable-mcp --register YOUR_CODE转换为令牌。3. 如需手写 OCR，获取 Google Vision API 密钥并配置环境变量GOOGLE_VISION_API_KEY。4. 在 MCP 客户端配置中添加服务器，例如 VS Code 的.vscode/mcp.json或 Claude Desktop 的配置文件。5. 根据连接模式启动 MCP 服务器。
claude_desktop_config.json
{
"mcpServers": {
"remarkable": {
"command": "uvx",
"args": ["remarkable-mcp", "--usb"],
"env": {
"GOOGLE_VISION_API_KEY": "your-api-key"
}
}
}
}
选型与风险
不适合谁
- 不需要 reMarkable 设备或不想管理多个 API 密钥的用户。
- 需要官方支持或企业级 SLA 的团队。
- 对硬件无所有权且希望自定义协议的用户。
所需权限
- 需要访问 reMarkable 云 API 的认证令牌（`REMARKABLE_TOKEN`）——必须保密。
- USB/SSH 模式需要 USB 连接和/或 SSH 权限，并可访问平板文件系统。
- 默认启用写入操作；删除等破坏性操作需要确认（如果客户端支持）或设置 `REMARKABLE_SKIP_CONFIRM=1`。
- 可选 Google Vision API 密钥用于 OCR。
风险与副作用
- 写入工具可能导致数据丢失；删除是破坏性的，务必谨慎。
- 云模式需要 reMarkable Connect 订阅，可能产生成本。
- Google Vision OCR 可能产生费用（每月 1000 次免费请求，超出后每千次约 1.50 美元）。
- 无意中将敏感笔记暴露给 AI 提供商的风险。
- SSH 模式需要开发者模式，可能导致保修失效。
常见排障
- USB 连接失败：检查平板是否已解锁且 USB 连接正常，验证在设置→存储中启用了“USB web 接口”。
- 云端认证失败：确认令牌有效，必要时重新注册。
- OCR 不工作：检查 `REMARKABLE_OCR_BACKEND` 设置和 API 密钥。
- 性能问题：调整 `REMARKABLE_SYNC_WORKERS` 和缓存设置。
- 连接被拒绝：确保防火墙或网络允许访问平板 IP（如 10.11.99.1）。
使用场景
研究写作：将手写笔记传递到 Obsidian 等笔记应用。
每日回顾：让 AI 总结近期笔记、查找待办事项。
文档搜索：在整个笔记库中搜索，包括手写内容。
知识管理：将 reMarkable 作为 AI 可访问的第二大脑。
支持客户端
Claude完整支持
VS Code Copilot完整支持
ChatGPT完整支持