reMarkable MCP Server

Раскройте весь потенциал вашего планшета reMarkable как второго мозга для ИИ-ассистентов. Этот MCP-сервер позволяет Claude, VS Code Copilot и другим ИИ-инструментам читать, искать и просматривать всю вашу библиотеку reMarkable — включая рукописные заметки с помощью OCR.

Почему rm-mcp?

Ваш планшет reMarkable — это мощный инструмент для размышлений, заметок и исследований. Но эти знания остаются запертыми на устройстве. Этот MCP-сервер меняет ситуацию:

• Полный доступ к библиотеке — Просматривайте папки, ищите документы, читайте любые файлы

• Извлечение печатного текста — Встроенная поддержка Type Folio и печатных аннотаций

• OCR рукописного текста — Преобразуйте рукописные заметки в искомый текст

• Поддержка PDF и EPUB — Извлекайте текст из документов, а также ваши аннотации

• Умный поиск — Находите содержимое по всей библиотеке

• Упорядочивайте библиотеку — Переименуйте, перемещайте и создавайте папки (ничто никогда не удаляется)

• Интеграция второго мозга — Используйте с Obsidian, приложениями для заметок или любым ИИ-рабочим процессом

Исследуете ли вы, пишете или развиваете идеи, rm-mcp позволяет вам использовать всё, что есть на вашем 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/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, чтобы уменьшить расход токенов в ответах

• Пакетный поиск — Поиск по нескольким документам за один вызов

• Поддержка зрения — Получайте изображения страниц для визуального контекста (диаграммы, макеты, наброски)

• Sampling OCR — Используйте ИИ клиента для OCR изображений (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 использует sampling OCR — модель ИИ вашего MCP-клиента извлекает текст из рукописных заметок. Никаких дополнительных API-ключей или сервисов не требуется.

Как это работает

Когда вы используете include_ocr=True, rm-mcp отправляет изображения страниц LLM вашего клиента (Claude, GPT-4 и т. д.) через MCP sampling. Модель читает рукописный текст и возвращает текст.

Использование

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

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

Требования

• Ваш MCP-клиент должен поддерживать возможность sampling (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 недоступны

Полезно для:

• Сосредоточения на рабочих документах в рабочее время

• Разделения личных и рабочих заметок

• Ограничения области действия для конкретных ИИ-рабочих процессов

Пользовательский цвет фона

Задайте цвет фона по умолчанию для отрисовки изображений:

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

Поддерживаемые форматы:

• #RRGGBB — RGB hex (например, #FFFFFF для белого)

• #RRGGBBAA — RGBA hex (например, #00000000 для прозрачного)

По умолчанию используется #FBFBFB (цвет бумаги reMarkable). Это влияет и на инструмент remarkable_image, и на ресурсы изображений.

Все переменные окружения

Большинству пользователей нужен только REMARKABLE_TOKEN. Остальные предназначены для тонкой настройки.

Варианты использования

Исследования и написание текстов

Используйте rm-mcp при работе в хранилище Obsidian или аналогичном, чтобы переносить знания из рукописных заметок в структурированные документы. ИИ может читать ваши исследовательские заметки и помогать развивать ваши идеи.

Ежедневный обзор

Попросите вашего ИИ-ассистента обобщить недавние заметки, найти пункты действий или выявить закономерности в ваших дневниковых записях.

Поиск документов

Найдите ту самую полузабытую заметку, выполнив поиск по всей библиотеке — включая рукописное содержимое.

Управление знаниями

Относитесь к своему reMarkable как ко второму мозгу, к которому ИИ имеет доступ. В сочетании с такими инструментами, как 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.