reMarkable MCP Server (Read/Write)

reMarkable MCP サーバー

AI アシスタントの第二の脳として、reMarkable タブレットの可能性を最大限に引き出しましょう。この MCP サーバーを使うと、Claude、VS Code Copilot、その他の AI ツールから、手書きメモの OCR も含め、reMarkable ライブラリ全体の読み取り、検索、参照ができます。

remarkable-mcp を使う理由

reMarkable タブレットは、思考、メモ、調査に役立つ強力なツールです。しかし、知識はデバイス内に閉じ込められたままです。この MCP サーバーで、その状況を変えられます。

• ライブラリ全体にアクセス — フォルダーの閲覧、ドキュメントの検索、あらゆるファイルの読み取り
• 入力テキストの抽出 — Type Folio や入力した注釈をネイティブにサポート
• 手書き文字の OCR — 手書きメモを検索可能なテキストに変換
• PDF と EPUB のサポート — ドキュメントからテキストと注釈を抽出
• スマート検索 — ライブラリ全体からコンテンツを検索
• 第二の脳との連携 — Obsidian、メモアプリ、あらゆる AI ワークフローで利用

調査、執筆、アイデアの創出など、どのような作業でも remarkable-mcp を使えば、AI を通じて reMarkable 上のあらゆるものを活用できます。

クイックインストール

🔌 USB Web インターフェース（推奨）

USB で接続し、タブレットのストレージ設定で Web インターフェースを有効にしてください。

セットアップ：

1. reMarkable を USB で接続します
2. タブレットで Settings → Storage を開き、"USB web interface" を有効にします
3. 上のボタンからインストールします

USB Web を使う理由

• ✅ USB 経由で高速かつオフラインでアクセス
• ✅ サブスクリプション不要
• ✅ ストレージ設定で有効にするだけの簡単な設定

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--usb"],
      "env": {
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

⚡ SSH モード（上級者向け）

ファイルシステムへ直接アクセスする必要があるパワーユーザー向けです。USB Web より高速ですが、開発者モード（工場出荷時設定へのリセットが必要）が必要です。

要件： 開発者モードを有効化 ＋ reMarkable に USB 接続

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--ssh"],
      "env": {
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

☁️ クラウドモード（ワイヤレス）

USB が使えない場合のワイヤレスまたはリモートアクセス向けです。reMarkable Connect のサブスクリプションが必要で、USB モードより大幅に低速です。

uvx remarkable-mcp --register YOUR_CODE

{
  "inputs": [
    {
      "type": "promptString",
      "id": "remarkable-token",
      "description": "reMarkable API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google-vision-key",
      "description": "Google Vision API Key",
      "password": true
    }
  ],
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp"],
      "env": {
        "REMARKABLE_TOKEN": "${input:remarkable-token}",
        "GOOGLE_VISION_API_KEY": "${input:google-vision-key}"
      }
    }
  }
}

接続モード

最適な接続方法を選択してください。

📖 詳細なセットアップガイド：

• USB Web インターフェースのセットアップ — 推奨 — 簡単にセットアップでき、すべての機能を利用できます
• SSH セットアップガイド — ファイルシステムへのアクセスが必要な上級ユーザー向け
• クラウドのセットアップについては、上記のクイックインストールのセクションに記載されています

OpenClaw との連携

remarkable-mcp はOpenClawのスキルとして動作します。openclaw.json に追加してください。

{
  "mcpServers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--usb"]
    }
  }
}

ClawHubからインストールします。

clawhub install remarkable-mcp

または、このリポジトリの SKILL.md を ~/.openclaw/skills/remarkable-mcp/ ディレクトリにコピーします。

ツール

すべてのツールは、次のアクションのヒントを含む構造化 JSON を返します。

📖 ツールの詳細なドキュメント

Claude Code との連携

~/.claude/settings.json に追加してください。

{
  "mcpServers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp-rw", "--wifi"],
      "env": {
        "REMARKABLE_HOST": "http://YOUR_TABLET_IP"
      }
    }
  }
}

WiFi のセットアップ

1. reMarkable で、設定 → ストレージに移動し、**「USB web interface」**を有効にします
2. タブレットの IP アドレスを確認します：設定 → 一般 → 端末情報 → IP アドレス
3. 上記の設定で REMARKABLE_HOST を http://YOUR_IP に設定します
4. USB Web インターフェースは、同じネットワーク上で USB 接続と WiFi 接続の両方に対応しています

スマート機能

• 自動リダイレクト — ドキュメントのパスを参照すると、その内容が自動的に返されます
• 自動 OCR — 入力されたテキストがないノートブックでは、OCR が自動的に有効になります
• 一括検索 — 1 回の呼び出しで複数のドキュメントを検索します
• 画像認識への対応 — 視覚的なコンテキスト（図、モックアップ、スケッチなど）を把握するためにページ画像を取得します
• サンプリング OCR — クライアントの AI を使って画像の OCR を実行します（API キーは不要です）
• タグへの対応 — タグでドキュメントを絞り込み、整理できます

使用例

# Read a document
remarkable_read("Meeting Notes")

# Search for keywords
remarkable_read("Project Plan", grep="deadline")

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

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

# Filter by tags
remarkable_browse("/", tags=["important"])
remarkable_browse("/Work", tags=["project", "active"])

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

# Search with tag filter
remarkable_search("project", tags=["work"])

# Get recent documents
remarkable_recent(limit=10)

# Get a page image (for visual content like UI mockups or diagrams)
remarkable_image("UI Mockup", page=1)

# Get SVG for editing in design tools
remarkable_image("Wireframe", output_format="svg")

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

# Transparent background for compositing
remarkable_image("Logo Sketch", background="#00000000")

# Compatibility mode: return resource URI instead of embedded resource
remarkable_image("Diagram", compatibility=True)

リソース

ドキュメントは MCP リソースとして自動的に登録されます。

📖 リソースの詳細なドキュメント

手書き文字の OCR

手書きの内容に対して、remarkable-mcp は複数の OCR バックエンドを提供しています。セットアップや要件に応じて選択してください。

クイックセットアップ

MCP 設定で REMARKABLE_OCR_BACKEND を設定します。

{
  "env": {
    "REMARKABLE_OCR_BACKEND": "sampling"
  }
}

オプション： sampling、google、tesseract、auto

# Install Tesseract
# macOS
brew install tesseract

# Ubuntu/Debian
sudo apt install tesseract-ocr

# Windows
choco install tesseract

デフォルトの動作（auto）

REMARKABLE_OCR_BACKEND=auto（デフォルト）の場合：

1. Google Vision（GOOGLE_VISION_API_KEY が設定されている場合）
2. Tesseract（フォールバック）

SSH とクラウドの比較

📖 SSH セットアップガイド

詳細設定

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

MCP サーバーがアクセスする reMarkable 上のフォルダーを指定します。すべての操作はこのフォルダー内に限定されます。

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--ssh"],
      "env": {
        "REMARKABLE_ROOT_PATH": "/Work",
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

この設定の場合：

• remarkable_browse("/") は /Work の内容を表示します
• remarkable_browse("/Projects") は /Work/Projects を表示します
• /Work 外のドキュメントにはアクセスできません

次のような場合に便利です：

• 勤務時間中に業務ドキュメントに集中する
• 個人用と業務用のメモを分ける
• 特定の AI ワークフローで対象範囲を制限する

カスタム背景色

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

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--ssh"],
      "env": {
        "REMARKABLE_BACKGROUND_COLOR": "#FFFFFF"
      }
    }
  }
}

対応形式：

• #RRGGBB — RGB の 16 進数（例：白の場合は #FFFFFF）
• #RRGGBBAA — RGBA の 16 進数（例：透明の場合は #00000000）

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

使用例

リサーチと執筆

Obsidian ボルトなどを使用しながら remarkable-mcp を使うと、手書きのメモから構造化されたドキュメントへ知識を移せます。AI はリサーチメモを読み取り、アイデアの発展を支援できます。

日々の振り返り

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

ドキュメント検索

手書きの内容も含め、ライブラリ全体を検索して、うろ覚えのメモを見つけられます。

ナレッジマネジメント

AI がアクセスできる第二の脳として reMarkable を活用できます。Obsidian などのツールと組み合わせることで、強力な個人用ナレッジシステムを構築できます。

ドキュメント

Development

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

📖 Development Guide

License

MIT

Built with rmscene, PyMuPDF, and inspiration from ddvk/rmapi.