mcp-readwise

Servidor MCP para Readwise construido sobre FastMCP. Proporciona 17 herramientas que cubren destacados, libros, etiquetas, documentos de Reader y exportación masiva.

Instalación

uv sync

O con pip:

pip install .

Related MCP server: Kiseki-Labs-Readwise-MCP

Configuración

Establezca las siguientes variables de entorno:

Variable	Requerido	Predeterminado	Descripción
`READWISE_TOKEN`	Sí	-	Token de acceso a la API de Readwise
`TRANSPORT`	No	`stdio`	Modo de transporte: `stdio` o `http`
`HOST`	No	`127.0.0.1`	Host del servidor HTTP
`PORT`	No	`8000`	Puerto del servidor HTTP
`MCP_API_KEY`	No	-	Token Bearer para la autenticación en el Portal MCP
`READWISE_BASE_URL`	No	`https://readwise.io`	URL base de la API de Readwise

Obtenga su token de acceso de Readwise en: https://readwise.io/access\\\\_token

Uso

Local (stdio)

READWISE_TOKEN=your_token uv run mcp-readwise

Modo HTTP

READWISE_TOKEN=your_token TRANSPORT=http uv run mcp-readwise

Docker

cp .env.example .env  # Add your READWISE_TOKEN
docker compose up -d

Herramientas disponibles

Destacados

Herramienta	Descripción
`search_highlights`	Buscar usando modo semántico, de texto completo o híbrido
`list_highlights`	Listar con filtros (libro, etiqueta, fecha) y paginación
`get_highlight`	Obtener por ID con metadatos del libro
`create_highlight`	Crear en un libro con nota/etiquetas opcionales
`update_highlight`	Actualizar texto o nota
`delete_highlight`	Eliminar por ID
`export_highlights`	Exportación masiva con paginación por cursor

Libros

Herramienta	Descripción
`list_books`	Listar con filtros de categoría/fuente/anotación
`get_book`	Obtener por ID

Etiquetas

Herramienta	Descripción
`list_tags`	Listar todas las etiquetas
`create_tag`	Crear una nueva etiqueta
`delete_tag`	Eliminar por ID
`tag_highlight`	Añadir o eliminar una etiqueta en un destacado

Reader

Herramienta	Descripción
`list_documents`	Listar documentos de Reader con filtros de ubicación/categoría
`get_document`	Obtener por ID con contenido completo
`save_url`	Guardar una URL en Reader
`update_progress`	Actualizar el progreso de lectura (0.0-1.0)

Estructura del proyecto

mcp_readwise/
  server.py      # FastMCP app, tool registration, entry point
  config.py      # pydantic-settings configuration
  client.py      # Centralized httpx client (auth, retries, rate limits)
  auth.py        # Bearer token verifier for MCP Portal
  models/        # Pydantic response models
  tools/         # Tool functions by domain

Despliegue

Desplegado a través de Komodo en ubuntu-smurf-mirror, accesible a través del Portal MCP de Cloudflare en mcp-readwise.cdit-dev.de.

Licencia

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Readwise MCP HTTP Server