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를 통해 reMarkable의 모든 것을 AI로 활용할 수 있습니다.

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를 사용하여 응답의 토큰 사용량 줄이기

• 일괄 검색 — 한 번의 호출로 여러 문서 검색

• 비전 지원 — 시각적 맥락을 위한 페이지 이미지 가져오기 (다이어그램, 목업, 스케치)

• 샘플링 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에서 영감을 받았습니다.