Readwise Reader

Un servidor MCP para la API de Readwise Reader para acceder y gestionar tus artículos y destacados.

Documentación

Servidor MCP de Readwise Reader

Un servidor de Model Context Protocol (MCP) para la API de Readwise Reader, construido con TypeScript y el SDK oficial de Claude.

Características

Autenticación segura: Utiliza variables de entorno para el almacenamiento de tokens
Gestión de documentos: Guardar, listar, actualizar y eliminar documentos con metadatos completos
Gestión de etiquetas: Listar y filtrar por etiquetas
Filtrado enriquecido: Filtrar documentos por ubicación, categoría, etiquetas y más
Soporte de paginación: Manejar colecciones de documentos grandes
Contenido amigable para LLM: El contenido HTML se convierte automáticamente a texto limpio usando r.jina.ai
Acceso completo a datos: Devuelve información completa del documento, incluyendo contenido, metadatos y marcas de tiempo

Documentación de la API

Para obtener información detallada sobre los endpoints, parámetros y ejemplos de la API de Readwise Reader, consulte la documentación oficial de la API:

📖 Documentación de la API de Readwise Reader

Este servidor MCP implementa todos los endpoints principales descritos en la documentación oficial.

Instalación

npm install
npm run build

Configuración

Con Claude Desktop

Construya el servidor MCP:
```
npm install
npm run build
```
Obtenga su token de acceso de Readwise desde: https://readwise.io/access_token
Agregue el servidor a la configuración de Claude Desktop. Abra la configuración de Claude Desktop y agregue esto a la configuración de sus servidores MCP:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
```
{
  "mcpServers": {
    "readwise-reader": {
      "command": "node",
      "args": ["/path/to/your/reader_readwise_mcp/dist/index.js"],
      "env": {
        "READWISE_TOKEN": "your_readwise_access_token_here"
      }
    }
  }
}
```
Reemplace:
- /path/to/your/reader_readwise_mcp con la ruta real a este directorio del proyecto
- your_readwise_access_token_here con su token de acceso real de Readwise
Reinicie Claude Desktop

Herramientas disponibles

`readwise_save_document`

Guarda un documento (URL o contenido HTML) en Readwise Reader.

Parámetros:

url (obligatorio): URL del documento a guardar
html (opcional): Contenido HTML del documento
tags (opcional): Matriz de etiquetas a agregar
location (opcional): Ubicación para guardar (new, later, shortlist, archive, feed)
category (opcional): Categoría del documento (article, book, tweet, pdf, email, youtube, podcast)

`readwise_list_documents`

Lista documentos de Readwise Reader con filtrado opcional. Devuelve información completa del documento, incluyendo metadatos y contenido de texto amigable para LLM.

Parámetros:

id (opcional): Filtrar por ID de documento específico
updatedAfter (opcional): Filtrar documentos actualizados después de esta fecha (ISO 8601)
location (opcional): Filtrar por ubicación del documento
category (opcional): Filtrar por categoría del documento
tag (opcional): Filtrar por nombre de etiqueta
pageCursor (opcional): Cursor de página para paginación
withHtmlContent (opcional): ⚠️ ADVERTENCIA DE RENDIMIENTO: Incluir contenido HTML en la respuesta. Esto ralentiza significativamente la API. Úselo solo cuando el usuario lo solicite explícitamente o cuando se necesite HTML sin procesar específicamente para la tarea.
withFullContent (opcional): ⚠️ ADVERTENCIA DE RENDIMIENTO: Incluir contenido de texto completo convertido en la respuesta. Esto ralentiza significativamente la API, ya que obtiene y procesa el contenido de cada documento. Úselo solo cuando el usuario lo solicite explícitamente o cuando se necesite el contenido del documento específicamente para análisis/lectura. Valor predeterminado: false por rendimiento.

Devuelve: Objetos de documento completos con todos los campos disponibles:

id, title, author, url, source_url, summary
published_date, image_url, location, category
tags, created_at, updated_at
content: Contenido de texto amigable para LLM (convertido desde source_url o url mediante r.jina.ai)

`readwise_update_document`

Actualiza un documento en Readwise Reader.

Parámetros:

id (obligatorio): ID del documento a actualizar
title (opcional): Nuevo título
author (opcional): Nuevo autor
summary (opcional): Nuevo resumen
published_date (opcional): Nueva fecha de publicación (ISO 8601)
image_url (opcional): Nueva URL de imagen
location (opcional): Nueva ubicación
category (opcional): Nueva categoría

`readwise_delete_document`

Elimina un documento de Readwise Reader.

Parámetros:

id (obligatorio): ID del documento a eliminar

`readwise_list_tags`

Lista todas las etiquetas de Readwise Reader.

Parámetros: Ninguno

`readwise_topic_search`

Busca documentos en Readwise Reader por tema utilizando coincidencia de expresiones regulares en título, resumen, notas y etiquetas.

Parámetros:

searchTerms (obligatorio): Matriz de términos de búsqueda para comparar con el contenido del documento (coincidencia de expresiones regulares sin distinción de mayúsculas y minúsculas)

Devuelve: Resultados de búsqueda con documentos coincidentes, incluyendo:

Términos de búsqueda utilizados
Número total de coincidencias
Objetos de documento completos con todos los metadatos disponibles (mismos campos que readwise_list_documents)

Autenticación

El servidor requiere un token de acceso de Readwise proporcionado a través de la variable de entorno READWISE_TOKEN. Este token se utiliza para autenticar todas las solicitudes de API a Readwise Reader.

Nota de seguridad: El token se almacena en su configuración de MCP y nunca se expone a través de Claude o la interfaz de herramientas.

Límites de velocidad

Predeterminado: 20 solicitudes/minuto
CREAR/ACTUALIZAR documento: 50 solicitudes/minuto
Las respuestas 429 incluyen el encabezado "Retry-After"

Licencia

MIT