Remarkable MCP

🚀 reMarkable MCP Server

reMarkableタブレットをAIアシスタントのセカンドブレインとして、その全ての可能性を引き出しましょう。このMCPサーバーにより、Claude、VS Code Copilot、その他のAIツールが、OCRを通じた手書きノートを含む、reMarkableライブラリ全体を読み取り、検索し、移動することができます。

🚀 クイックスタート

✨ 主な機能

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

• ライブラリ全体へのアクセス — フォルダを閲覧し、ドキュメントを検索し、任意のファイルを読み取ることができます。
• 入力テキストの抽出 — Type Folioと入力注釈に対するネイティブサポート。
• 手書き文字のOCR — 手書きノートを検索可能なテキストに変換します。
• PDFとEPUBのサポート — ドキュメントからテキストを抽出し、注釈も含めます。
• スマート検索 — ライブラリ全体のコンテンツを検索します。
• セカンドブレインとの統合 — Obsidian、ノートアプリ、または任意のAIワークフローと組み合わせて使用できます。

調査、執筆、アイデアの開発のいずれの場面でも、remarkable - mcpを通じてreMarkable上のすべての情報をAIで活用することができます。

📦 インストール

⚡ SSHモード (推奨)

USBを介して直接接続することで、10 - 100倍高速なアクセス、オフライン操作が可能で、サブスクリプションも不要です。

必要条件: 開発者モードを有効にする + reMarkableへのUSB接続

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

☁️ クラウドモード (代替案)

開発者モードを有効にできない場合は、クラウドAPIを使用します。reMarkable Connectのサブスクリプションが必要です。

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}"
      }
    }
  }
}

💻 使用例

基本的な使用法

# ドキュメントを読み取る
remarkable_read("Meeting Notes")

# キーワードを検索する
remarkable_read("Project Plan", grep="deadline")

# 手書きノートにOCRを適用する
remarkable_read("Journal", include_ocr=True)

# ライブラリを閲覧する
remarkable_browse("/Work/Projects")

# ドキュメント全体を検索する
remarkable_search("meeting", grep="action items")

# 最近更新されたドキュメントを取得する
remarkable_recent(limit=10)

# ページの画像を取得する（UIモックアップやダイアグラムなどのビジュアルコンテンツ用）
remarkable_image("UI Mockup", page=1)

# デザインツールで編集するためのSVGを取得する
remarkable_image("Wireframe", output_format="svg")

# OCRテキスト抽出付きの画像を取得する（設定されている場合はサンプリングを使用）
remarkable_image("Handwritten Notes", include_ocr=True)

# 合成用の透過背景を設定する
remarkable_image("Logo Sketch", background="#00000000")

# 互換性モード：埋め込みリソースではなくリソースURIを返す
remarkable_image("Diagram", compatibility=True)

📚 ドキュメント

ツール

すべてのツールは読み取り専用で、次のアクションのヒントを含む構造化されたJSONを返します。

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

スマート機能

• 自動リダイレクト — ドキュメントパスを閲覧すると、自動的にそのコンテンツが返されます。
• 自動OCR — 入力テキストのないノートブックは自動的にOCRが有効になります。
• バッチ検索 — 一度の呼び出しで複数のドキュメントを横断して検索できます。
• ビジョンサポート — ビジュアルコンテキスト（ダイアグラム、モックアップ、スケッチ）のためのページ画像を取得します。
• サンプリングOCR — クライアントのAIを使用して画像のOCRを行います（APIキー不要）。

リソース

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

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

手書き文字のOCR

手書きコンテンツに対して、remarkable - mcpはいくつかのOCRバックエンドを提供しています。セットアップと要件に基づいて選択してください。

クイックセットアップ

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

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

オプション: sampling, google, tesseract, auto

# 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 — RGB16進数（例: #FFFFFF は白）
• #RRGGBBAA — RGBA16進数（例: #00000000 は透明）

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

使用例

調査と執筆

Obsidianボールトなどで作業する際に、remarkable - mcpを使用して、手書きノートからの知識を構造化されたドキュメントに移行することができます。AIが調査ノートを読み取り、アイデアの開発を支援します。

日次レビュー

AIアシスタントに最近のノートを要約し、アクションアイテムを見つけ、またはジャーナルエントリ全体のパターンを特定するように依頼します。

ドキュメント検索

ライブラリ全体を検索することで、半分忘れてしまったノートを見つけることができます — 手書きコンテンツも含みます。

知識管理

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

ドキュメント一覧

開発

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

📖 開発ガイド

📄 ライセンス

MIT

rmscene、PyMuPDFを使用して構築されており、ddvk/rmapiからインスピレーションを得ています。