reMarkable MCP Server

解锁你的 reMarkable 平板作为 AI 助手的第二大脑的全部潜力。这个 MCP 服务器让 Claude、VS Code Copilot 和其他 AI 工具能够读取、搜索和遍历你整个 reMarkable 资料库——包括通过 OCR 识别手写笔记。

为什么选择 rm-mcp？

你的 reMarkable 平板是思考、笔记和研究的有力工具。但这些知识一直被困在设备里。这个 MCP 服务器改变了这一点：

• 完整资料库访问 — 浏览文件夹、搜索文档、读取任意文件

• 文本提取 — 原生支持 Type Folio 和打字注释

• 手写 OCR — 将手写笔记转换为可搜索的文本

• PDF 与 EPUB 支持 — 从文档中提取文字，以及你的批注

• 智能搜索 — 在整个资料库中查找内容

• 整理资料库 — 重命名、移动和创建文件夹（绝不删除任何内容）

• 第二大脑集成 — 可与 Obsidian、笔记应用或任何 AI 工作流配合使用

无论你是在研究、写作还是构思，rm-mcp 都能让你通过 AI 充分利用 reMarkable 上的一切。

Related MCP server: io.github.praveensehgal/remarkable

快速安装

使用 reMarkable Cloud API。需要 reMarkable Connect 订阅。

一键设置（推荐）

uvx rm-mcp --setup

这会在浏览器中打开页面，提示你输入一次性代码，并打印可直接粘贴到 Claude Code 和 Claude Desktop 的配置。

手动设置

1. 获取一次性代码

前往 my.remarkable.com/device/connect 并生成一个代码。

2. 转换为 Token

uvx rm-mcp --register YOUR_CODE

3. 添加到 MCP 客户端

Claude Code：

claude mcp add remarkable \
  -e REMARKABLE_TOKEN='<paste token from step 2>' \
  -e REMARKABLE_OCR_BACKEND=sampling \
  -- uvx rm-mcp@latest

Claude Desktop — 添加到 claude_desktop_config.json（使用 uvx 的完整路径，例如通过 which uvx 获取）：

{
  "mcpServers": {
    "remarkable": {
      "command": "/Users/YOU/.local/bin/uvx",
      "args": ["rm-mcp@latest"],
      "env": {
        "REMARKABLE_TOKEN": "<paste token from step 2>"
      }
    }
  }
}

工具

所有工具均为只读，返回包含下一步操作提示的结构化 JSON。

I need to be careful about the ASCII art in GXP1 which represents a command. Let me check the source again for these placeholders...

Actually, looking at the source text more carefully:

• GXP1 - placeholder for a code block

• GXP2 - placeholder for code

• GXP3 - placeholder for config

• GXP4 - placeholder for config

• GXP5 - placeholder for code example

• GXP6 - placeholder for usage code

• GXP7 - placeholder for config code

• GXP8 - placeholder for config code

• GXP9 - placeholder for development instructions

These should be preserved exactly as they are in the output.

Let me translate the document carefully now, following the structure.# reMarkable MCP 服务器

释放你 reMarkable 平板电脑的全部潜力，将其作为 AI 助手的第二大脑。这个 MCP 服务器让 Claude、VS Code Copilot 及其他 AI 工具能够读取、搜索并遍历你整个 reMarkable 资料库——包括通过 OCR 识别手写笔记。

为什么选择 rm-mcp？

你的 reMarkable 平板是思考、记笔记和研究的强大工具。但这些知识一直被困在设备里。这个 MCP 服务器改变了这一点：

• 完整资料库访问 — 浏览文件夹、搜索文档、读取任何文件

• 键入文本提取 — 原生支持 Type Folio 和键入注释

• 手写 OCR — 将手写笔记转换为可搜索的文本

• PDF 与 EPUB 支持 — 从文档中提取文字，以及你的批注

• 智能搜索 — 在整个资料库中查找内容

• 整理资料库 — 重命名、移动和创建文件夹（绝不删除任何内容）

• 第二大脑集成 — 可用于 Obsidian、笔记应用或任何 AI 工作流

无论你是在研究、写作还是构思，rm-mcp 都能让你充分利用 reMarkable 上的所有内容。

快速安装

需要使用 reMarkable Cloud API。需要 reMarkable Connect 订阅。

一键安装

uvx rm-mcp --setup

这将打开你的浏览器，提示输入一次性代码，并为 Claude Code 和 Claude Desktop 生成可直接使用的配置。

手动安装

1. 获取一次性代码

前往 my.remarkable.com/browser/connect 获取代码。

2. 转换为 Token

uvx rm-mcp --register YOUR_CODE

3. 添加到你的 MCP 客户端

Claude Desktop — 编辑 claude_desktop_config.json（使用 uvx 的完整路径）：

claude mcp add remarkable \
  -e REMARKABLE_TOKEN='<paste token from step 2>' \
  -e REMARKABLE_OCR_BACKEND=sampling \
  -- uvx rm-mcp@latest

工具

所有工具均为只读，返回结构化的 JSON，并包含下一步操作提示。

📖 完整工具文档

智能功能

• 多页读取 — 使用 page="all" 或页码范围读取文档

• Grep 自动跳转 — 自动跳转到匹配页码

• 自动重定向 — 浏览文件夹时自动跳转到对应内容

• 自动 OCR — 无手写笔记的文档自动提取文本（可通过 include_ocr=False 关闭）

• 全文搜索 — 在多个文档中搜索内容

• 紧凑模式 — 减少响应中的 token 使用量

• 视觉支持 — 获取页面 PNG/SVG 图像（支持通过采样进行 OCR）

• 采样 OCR — 通过 MCP 采样调用客户端 LLM 识别手写内容（无需 API 密钥）

资源

📖 完整资源文档

OCR（光学字符识别）

本服务器支持采样 OCR — 通过 MCP 采样机制将手写笔记图像发送给客户端的 LLM（如 Claude）进行文本识别。无需 API 密钥。

工作原理

当你使用需要 OCR 的功能时，服务器会将页面图像通过 MCP 采样发送至你的客户端模型（Claude、GPT-4 等），模型识别手写内容并返回文本。

使用方法

# Read a document
remarkable_read("Meeting Notes")

# Read all pages at once
remarkable_read("Meeting Notes", pages="all")

# Read a range of pages
remarkable_read("Research Paper", pages="1-3")

# Search for keywords (auto-redirects to matching page)
remarkable_read("Project Plan", grep="deadline")

# Enable OCR for handwritten notes
remarkable_read("Journal", include_ocr=True)

# Browse your library
remarkable_browse("/Work/Projects")

# Search across documents
remarkable_search("meeting", grep="action items")

# Get recent documents with previews
remarkable_recent(limit=5, include_preview=True)

# Get a page image
remarkable_image("UI Mockup", page=1)

# Get image with OCR text extraction
remarkable_image("Handwritten Notes", include_ocr=True)

高级配置

根路径过滤

将 MCP 服务器限定到 reMarkable 上的特定文件夹。所有操作都将限定在该文件夹内：

# OCR on a page image
remarkable_image("Handwritten Notes", include_ocr=True)

# OCR when reading a notebook
remarkable_read("Journal", include_ocr=True)

配置示例：

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["rm-mcp"],
      "env": {
        "REMARKABLE_TOKEN": "your-token",
        "REMARKABLE_ROOT_PATH": "/Work"
      }
    }
  }
}

适用于：

• 办公时间只关注工作文档

• 将个人笔记与工作笔记分开管理

• 为特定 AI 工作流限定范围

认证

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["rm-mcp"],
      "env": {
        "REMARKABLE_TOKEN": "your-token",
        "REMARKABLE_BACKGROUND_COLOR": "#FFFFFF"
      }
    }
  }
}

使用 uvx rm-mcp 启动服务器时，通过环境变量提供认证信息：

使用场景

研究与写作

在 Obsidian 或类似笔记工具中使用 rm-mcp，可以将手写研究笔记转化为结构化文档。AI 可以读取你的研究笔记并帮助你推进想法。

每日回顾

让 AI 助手总结近期笔记、找出待办事项，或识别笔记中的模式。

文档搜索

通过跨整个资料库（包括手写内容）的搜索，找到那个模糊记得的笔记。

知识管理

将 reMarkable 视为 AI 可访问的第二大脑。结合 Obsidian 等工具，构建强大的个人知识管理系统。

文档

开发

{
  "mcpServers": {
    "remarkable": {
      "command": "/Users/YOU/.local/bin/uvx",
      "args": ["rm-mcp@latest"],
      "env": {
        "REMARKABLE_TOKEN": "<paste token from step 2>"
      }
    }
  }
}

📖 开发指南

许可证

MIT

基于 rmapi、PyMuPDF 和 librremarkable 构建。