reMarkable MCP Server

reMarkable タブレットの可能性を最大限に引き出し、AI アシスタントのためのセカンドブレインとして活用しましょう。この MCP サーバーを使用すると、Claude や VS Code Copilot などの AI ツールが、手書きメモ（OCR 経由）を含む reMarkable ライブラリ全体を読み取り、検索し、操作できるようになります。

rm-mcp の利点

reMarkable タブレットは、思考、メモ取り、リサーチのための強力なツールです。しかし、その知識はデバイス内に閉じ込められたままです。この MCP サーバーがそれを変えます：

• ライブラリ全体へのフルアクセス — フォルダの参照、ドキュメントの検索、あらゆるファイルの読み取り

• テキスト抽出 — Type Folio およびテキスト注釈のネイティブサポート

• 手書き文字の OCR — 手書きメモを検索可能なテキストに変換

• PDF・EPUB サポート — ドキュメントと注釈からテキストを抽出

• スマート検索 — ライブラリ全体からコンテンツを検索

• ライブラリの整理 — フォルダの名前変更、移動、作成（削除は一切行われません）

• セカンドブレイン統合 — Obsidian やメモアプリ、あらゆる AI ワークフローと連携

研究、執筆、アイデアの開発など、rm-mcp を使用すると、AI を通じて reMarkable 上のすべてを活用できます。

Related MCP server: io.github.praveensehgal/remarkable

クイックインストール

reMarkable クラウド API を使用します。reMarkable Connect サブスクリプションが必要です。

ワンコマンドセットアップ（推奨）

uvx rm-mcp --setup

ブラウザが開き、ワンタイムコードの入力が求められ、Claude Code と Claude Desktop 用にコピー＆ペースト可能な設定が出力されます。

手動セットアップ

1. ワンタイムコードを取得

my.remarkable.com/device/browser/connect にアクセスし、コードを生成します。

2. トークンに変換

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 を返します。

📖 ツール完全ドキュメント

スマート機能

• 複数ページの読み取り — pages="all" で全ページ、pages="1-3" のように範囲指定も可能

• grep 自動リダイレクト — grep は自動的に一致するページを検索してジャンプ

• 自動リダイレクト — ドキュメントパスを参照すると、そのコンテンツが自動的に返されます

• 自動 OCR — テキストが入力されていないノートブックは自動的に OCR を有効化（auto_ocr=False で無効化）

• 全文検索 — ドキュメントを読み取るとインデックスが作成され、その後の検索が高速化

• コンパクトモード — compact_output=True でレスポンスのトークン使用量を削減

• バッチ検索 — 1 回の呼び出しで複数のドキュメントを検索

• ビジョンサポート — 視覚的なコンテキスト（図、モックアップ、スケッチ）のためのページ画像を取得

• サンプリング OCR — 画像の OCR にクライアントの AI を使用（API キーは不要）

使用例

# 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 リソースとして登録されます：

📖 リソース完全ドキュメント

手書き文字の OCR

rm-mcp はサンプリング OCR を使用します。MCP クライアントの AI モデルが手書きメモからテキストを抽出します。追加の API キーやサービスは不要です。

仕組み

include_ocr=True を使用すると、rm-mcp は MCP サンプリングを介してページ画像をクライアントの LLM（Claude、GPT-4 など）に送信します。モデルが手書き文字を読み取り、テキストを返します。

使用方法

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

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

要件

• MCP クライアントがサンプリング機能に対応している必要があります（VS Code + Copilot、Claude Desktop など）

• REMARKABLE_OCR_BACKEND=sampling（デフォルト）

詳細設定

ルートパスフィルタリング

MCP サーバーを reMarkable の特定のフォルダに制限します。すべての操作がこのフォルダにスコープされます：

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

この設定の場合：

• remarkable_browse("/") は /Work の内容を表示

• remarkable_browse("/Projects") は /Work/Projects を表示

• /Work 外のドキュメントにはアクセス不可

次のような場合に役立ちます：

• 勤務時間中に仕事用ドキュメントに集中する

• 個人用メモと仕事用メモを分離する

• 特定の AI ワークフローにスコープを制限する

カスタム背景色

画像レンダリングのデフォルトの背景色を設定します：

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

サポートされている形式：

• #RRGGBB — RGB 16 進数（例：白は #FFFFFF）

• #RRGGBBAA — RGBA 16 進数（例：透明は #00000000）

デフォルトは #FBFBFB（reMarkable の紙の色）です。これは remarkable_image ツールと画像リソースの両方に影響します。

環境変数一覧

ほとんどのユーザーは REMARKABLE_TOKEN のみ必要です。残りは高度なチューニング用です。

ユースケース

リサーチとライティング

Obsidian ボールトなどで rm-mcp を使用して、手書きメモから構造化ドキュメントへ知識を転送します。AI が研究ノートを読み、アイデアの発展を支援します。

デイリーレビュー

AI アシスタントに最近のメモの要約、アクションアイテムの検索、日記エントリのパターン特定を依頼します。

ドキュメント検索

ライブラリ全体（手書きコンテンツを含む）を検索して、うろ覚えのメモを見つけます。

ナレッジマネジメント

reMarkable を AI がアクセスできるセカンドブレインとして扱います。Obsidian などのツールと組み合わせることで、強力なパーソナルナレッジシステムを構築できます。

ドキュメント

開発

git clone https://github.com/wavyrai/rm-mcp.git
cd rm-mcp
uv sync --all-extras
uv run pytest test_server.py -v

📖 開発ガイド

ライセンス

MIT

rmscene、PyMuPDF、ddvk/rmapi に触発されて構築されました。