mcp-readwise

MCP-сервер для Readwise, построенный на FastMCP. Предоставляет 17 инструментов для работы с выделениями, книгами, тегами, документами Reader и пакетным экспортом.

Установка

uv sync

Или с помощью pip:

pip install .

Related MCP server: Kiseki-Labs-Readwise-MCP

Конфигурация

Установите следующие переменные окружения:

Переменная	Обязательно	По умолчанию	Описание
`READWISE_TOKEN`	Да	-	Токен доступа к API Readwise
`TRANSPORT`	Нет	`stdio`	Режим транспорта: `stdio` или `http`
`HOST`	Нет	`127.0.0.1`	Хост HTTP-сервера
`PORT`	Нет	`8000`	Порт HTTP-сервера
`MCP_API_KEY`	Нет	-	Bearer-токен для аутентификации в MCP Portal
`READWISE_BASE_URL`	Нет	`https://readwise.io`	Базовый URL API Readwise

Получите свой токен доступа Readwise по адресу: https://readwise.io/access_token

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

Локально (stdio)

READWISE_TOKEN=your_token uv run mcp-readwise

Режим HTTP

READWISE_TOKEN=your_token TRANSPORT=http uv run mcp-readwise

Docker

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

Доступные инструменты

Выделения (Highlights)

Инструмент	Описание
`search_highlights`	Поиск с использованием семантического, полнотекстового или гибридного режима
`list_highlights`	Список с фильтрами (книга, тег, дата) и пагинацией
`get_highlight`	Получение по ID с метаданными книги
`create_highlight`	Создание в книге с опциональной заметкой/тегами
`update_highlight`	Обновление текста или заметки
`delete_highlight`	Удаление по ID
`export_highlights`	Пакетный экспорт с курсорной пагинацией

Книги

Инструмент	Описание
`list_books`	Список с фильтрами по категории/источнику/аннотации
`get_book`	Получение по ID

Reader

Инструмент	Описание
`list_documents`	Список документов Reader с фильтрами по местоположению/категории
`get_document`	Получение по ID с полным содержимым
`save_url`	Сохранение URL в Reader
`update_progress`	Обновление прогресса чтения (0.0-1.0)

Структура проекта

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

Развертывание

Развернуто через Komodo на ubuntu-smurf-mirror, доступно через Cloudflare MCP Portal по адресу mcp-readwise.cdit-dev.de.

Лицензия

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

Инструмент	Описание
`list_tags`	Список всех тегов
`create_tag`	Создание нового тега
`delete_tag`	Удаление по ID
`tag_highlight`	Добавление или удаление тега у выделения

Readwise MCP HTTP Server