mcp-readwise

基于 FastMCP 构建的 Readwise MCP 服务器。提供 17 种工具，涵盖高亮、书籍、标签、Reader 文档和批量导出功能。

安装

uv sync

或者使用 pip：

pip install .

Related MCP server: Kiseki-Labs-Readwise-MCP

配置

设置以下环境变量：

变量	必需	默认值	描述
`READWISE_TOKEN`	是	-	Readwise API 访问令牌
`TRANSPORT`	否	`stdio`	传输模式：`stdio` 或 `http`
`HOST`	否	`127.0.0.1`	HTTP 服务器主机
`PORT`	否	`8000`	HTTP 服务器端口
`MCP_API_KEY`	否	-	用于 MCP Portal 认证的 Bearer 令牌
`READWISE_BASE_URL`	否	`https://readwise.io`	Readwise API 基础 URL

在以下地址获取您的 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`	使用游标分页进行批量导出

书籍 (Books)

工具	描述
`list_books`	通过类别/来源/标注过滤器列出书籍
`get_book`	通过 ID 获取书籍

标签 (Tags)

工具	描述
`list_tags`	列出所有标签
`create_tag`	创建新标签
`delete_tag`	通过 ID 删除
`tag_highlight`	为高亮添加或移除标签

阅读器 (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

Readwise MCP HTTP Server