reMarkable MCP Server

Desbloquea todo el potencial de tu tableta reMarkable como segundo cerebro para asistentes de IA. Este servidor MCP permite a Claude, VS Code Copilot y otras herramientas de IA leer, buscar y recorrer toda tu biblioteca de reMarkable, incluidos los apuntes escritos a mano mediante OCR.

¿Por qué rm-mcp?

Tu tableta reMarkable es una herramienta potente para pensar, tomar notas e investigar. Pero ese conocimiento se queda atrapado en el dispositivo. Este servidor MCP lo cambia:

• Acceso completo a la biblioteca — Explora carpetas, busca documentos, lee cualquier archivo

• Extracción de texto mecanografiado — Compatibilidad nativa con Type Folio y anotaciones mecanografiadas

• OCR de escritura a mano — Convierte notas manuscritas en texto buscable

• Compatibilidad con PDF y EPUB — Extrae texto de documentos, además de tus anotaciones

• Búsqueda inteligente — Encuentra contenido en toda tu biblioteca

• Organiza tu biblioteca — Renombra, mueve y crea carpetas (nada se elimina nunca)

• Integración con el segundo cerebro — Úsalo con Obsidian, aplicaciones de notas o cualquier flujo de trabajo de IA

Tanto si estás investigando, escribiendo o desarrollando ideas, rm-mcp te permite aprovechar todo lo que hay en tu reMarkable mediante IA.

Related MCP server: io.github.praveensehgal/remarkable

Instalación rápida

Utiliza la API de reMarkable Cloud. Requiere una suscripción a reMarkable Connect.

Configuración en un solo comando (recomendado)

uvx rm-mcp --setup

Esto abre tu navegador, te solicita el código de un solo uso y muestra la configuración lista para pegar para Claude Code y Claude Desktop.

Configuración manual

1. Obtén un código de un solo uso

Ve a my.remarkable.com/device/browser/connect y genera un código.

2. Convierte en token

uvx rm-mcp --register YOUR_CODE

3. Añádelo a tu cliente 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 — añade a claude_desktop_config.json (usa la ruta completa a uvx, p. ej. desde which uvx):

{
  "mcpServers": {
    "remarkable": {
      "command": "/Users/YOU/.local/bin/uvx",
      "args": ["rm-mcp@latest"],
      "env": {
        "REMARKABLE_TOKEN": "<paste token from step 2>"
      }
    }
  }
}

Herramientas

Todas las herramientas son de solo lectura y devuelven JSON estructurado con sugerencias para las siguientes acciones.

📖 Documentación completa de herramientas

Funciones inteligentes

• Lectura multipágina — Lee todas las páginas de una vez con pages="all", o un rango como pages="1-3"

• Redirección automática de grep — grep encuentra y salta automáticamente a la página coincidente

• Redirección automática — Navegar a la ruta de un documento devuelve su contenido automáticamente

• OCR automático — Los cuadernos sin texto mecanografiado activan el OCR automáticamente (puedes desactivarlo con auto_ocr=False)

• Búsqueda de texto completo — Leer un documento lo indexa para búsquedas futuras rápidas

• Modo compacto — Usa compact_output=True para reducir el uso de tokens en las respuestas

• Búsqueda por lotes — Busca en varios documentos en una sola llamada

• Compatibilidad con visión — Obtén imágenes de páginas para contexto visual (diagramas, maquetas, bocetos)

• OCR por sampling — Usa la IA del cliente para OCR en imágenes (sin necesidad de clave API)

Ejemplo de uso

# 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)

Recursos

Los documentos se registran automáticamente como recursos MCP:

📖 Documentación completa de recursos

OCR para escritura a mano

rm-mcp utiliza sampling OCR: el modelo de IA de tu cliente MCP extrae el texto de las notas manuscritas. No se necesitan claves API ni servicios adicionales.

Cómo funciona

Cuando usas include_ocr=True, rm-mcp envía imágenes de las páginas al LLM de tu cliente (Claude, GPT-4, etc.) mediante MCP sampling. El modelo lee la escritura a mano y devuelve el texto.

Uso

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

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

Requisitos

• Tu cliente MCP debe ser compatible con la capacidad de sampling (VS Code + Copilot, Claude Desktop, etc.)

• REMARKABLE_OCR_BACKEND=sampling (este es el valor predeterminado)

Configuración avanzada

Filtrado por ruta raíz

Limita el servidor MCP a una carpeta específica de tu reMarkable. Todas las operaciones se limitarán a esta carpeta:

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

Con esta configuración:

• remarkable_browse("/") muestra el contenido de /Work

• remarkable_browse("/Projects") muestra /Work/Projects

• Los documentos fuera de /Work no son accesibles

Útil para:

• Centrarse en los documentos de trabajo durante el horario laboral

• Separar las notas personales y profesionales

• Limitar el alcance para flujos de trabajo de IA específicos

Color de fondo personalizado

Establece el color de fondo predeterminado para el renderizado de imágenes:

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

Formatos compatibles:

• #RRGGBB — RGB hexadecimal (p. ej., #FFFFFF para blanco)

• #RRGGBBAA — RGBA hexadecimal (p. ej., #00000000 para transparente)

El valor predeterminado es #FBFBFB (color de papel de reMarkable). Esto afecta tanto a la herramienta remarkable_image como a los recursos de imagen.

Todas las variables de entorno

La mayoría de los usuarios solo necesitan REMARKABLE_TOKEN. El resto es para ajustes avanzados.

Casos de uso

Investigación y escritura

Usa rm-mcp mientras trabajas en una bóveda de Obsidian o similar para transferir el conocimiento de tus notas manuscritas a documentos estructurados. La IA puede leer tus notas de investigación y ayudarte a desarrollar tus ideas.

Revisión diaria

Pídele a tu asistente de IA que resuma tus notas recientes, encuentre tareas pendientes o identifique patrones en las entradas de tu diario.

Búsqueda de documentos

Encuentra esa nota que recuerdas a medias buscando en toda tu biblioteca, incluido el contenido manuscrito.

Gestión del conocimiento

Trata tu reMarkable como un segundo cerebro al que la IA pueda acceder. Combinado con herramientas como Obsidian, puedes crear un potente sistema de conocimiento personal.

Documentación

Desarrollo

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

📖 Guía de desarrollo

Licencia

MIT

Construido con rmscene, PyMuPDF e inspiración de ddvk/rmapi.