Readwise MCP（mcporter）是一个专为开发者设计的命令行工具，用于与 Readwise 的阅读数据生态系统进行安全、高效的交互。它通过标准化的 MCP（Model Context Protocol）接口，将 Readwise 的核心功能封装为可调用工具，使开发者能够在自动化工作流中直接访问个人高亮笔记、Reader 文档库以及标签系统。该工具特别适用于需要批量处理阅读内容、构建知识管理系统或实现个性化推荐逻辑的场景。首次使用需通过 mcporter CLI 完成项目配置和 OAuth 认证流程，整个过程在终端内引导完成，无需手动操作浏览器授权页面。一旦设置完成，所有对 Readwise 的操作均可通过统一的 `mcporter call` 命令发起，返回结构化的 JSON 数据，便于后续集成到其他应用或服务中。
核心功能特点
- 支持完整的 OAuth 2.0 认证流程，自动管理会话状态与端口绑定
- 提供 15+ 个预定义工具接口，涵盖高亮搜索、文档管理、标签操作等核心功能
- 采用 JSON 输入输出格式，确保与各类开发环境无缝对接
- 内置安全机制：执行写操作前默认展示只读计划并请求用户确认
- 支持语义向量搜索与混合检索，提升内容发现效率
- 兼容多种 Reader 位置模型（inbox/later/shortlist/archive），适配不同用户习惯
适用场景
Readwise MCP 最典型的应用场景是构建个人知识自动化流水线。例如，当用户每天收到大量 RSS 订阅源时，可通过定时任务调用 `reader_list_documents` 获取最新未读文章，再结合 `readwise_search_highlights` 分析历史高亮主题，智能筛选出与当前兴趣匹配的内容推送到指定位置。另一个高频用例是‘短名单’整理：用户可将重要文章先移至 later 位置，并添加 shortlist 标签，后续由系统根据阅读频率和标签关联性生成推荐阅读列表。对于深度研究者而言，该工具还能辅助创建‘问答式复习’流程——从 archive 中提取近期归档文档，提取其高亮片段生成测验题目，强化长期记忆。此外，团队协作场景中也可利用其导出功能批量下载共享资料，统一打上分类标签后归档至团队知识库。所有涉及修改原始数据的操作（如移动文档、设置笔记）都会触发二次确认提示，有效防止误操作。