Readwise Enhanced MCP Server

@arnaldo-delisio

リポジトリ

基本情報

カテゴリ

その他

トランスポート

stdio

作者

arnaldo-delisio

投稿者

Arnaldo De Lisio

Readwise Enhanced MCP Server について

概要はまだありません

#readwise#mcp #document-management

Readwise Enhanced MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "readwise-mcp-enhanced": {
      "command": "npx",
      "args": [
        "readwise-mcp-enhanced"
      ],
      "env": {
        "READWISE_TOKEN": "your_readwise_access_token_here"
      }
    }
  }
}

Readwise Enhanced MCP Server のツール

Save a document (URL or HTML content) to Readwise Reader

List documents from Readwise Reader with optional filtering

Update a document in Readwise Reader

Delete a document from Readwise Reader

List all tags from Readwise Reader

Search documents in Readwise Reader by topic using regex matching on title, summary, notes, and tags

List highlights from Readwise with optional filtering by book, date, or other criteria

Create new highlights manually in Readwise

Export all highlights from Readwise with optional filtering. Perfect for bulk analysis or backup.

Get your daily review highlights for spaced repetition learning

List books that have highlights in Readwise with optional filtering

Get all highlights from a specific book

Advanced search across all highlights using text queries and field-specific filters. Equivalent to official Readwise MCP search functionality.

概要

What is Readwise Enhanced Mcp?

Readwise Enhanced Mcp is a comprehensive Model Context Protocol (MCP) server that unifies Readwise Reader document management with full Readwise highlights functionality. It works with Claude Desktop, Continue, and any MCP‑compatible AI tool, offering AI‑powered text processing and context‑optimized responses.

How to use Readwise Enhanced Mcp?

Install via npx (recommended), global npm, or from source. Obtain a Readwise access token from your Readwise account, then add the server configuration to your MCP client (e.g., Claude Desktop or Continue) using the READWISE_TOKEN environment variable. Restart the client to access the 13 built‑in tools for Reader and Highlights operations.

Key features of Readwise Enhanced Mcp

Smart content extraction with pagination and keyword filtering
AI‑powered word segmentation that fixes merged tokens
Complete highlights ecosystem: daily reviews, search, books, export
Context optimization achieving 94% token reduction
Unlimited results with efficient data per item
Dual v2 (Highlights) and v3 (Reader) API integration

Use cases of Readwise Enhanced Mcp

Paginate through large Reader documents with content controls.
Search across documents and highlights with field‑specific queries.
Run daily spaced‑repetition reviews with related highlight retrieval.
Bulk export highlights for backup or external analysis.
Manage full Readwise library—save, update, delete, and tag documents.

よくある質問

How does this server authenticate with Readwise?

Authentication uses a single Readwise access token stored in the `READWISE_TOKEN` environment variable. The token is never exposed through the MCP client or tool interface.

What are the rate limits?

The Reader API allows 20 requests per minute (50 for CREATE/UPDATE), and the Highlights API follows standard Readwise limits. The server automatically handles 429 responses with “Retry‑After” headers.

Is this server backward compatible with basic Reader MCP servers?

Yes—it is fully backward compatible. All existing Reader tools work unchanged while adding seven new Highlights tools, with no breaking changes.

What dependencies does the server require?

Key dependencies are `@modelcontextprotocol/sdk`, `dotenv`, `node-html-parser`, and `wordsninja` (for AI‑powered word segmentation). It is built with TypeScript and follows ES Module standards.

How does the context optimization work?

The server returns only essential fields (e.g., `id`, `text`, `book_id` for highlights) rather than full API responses, achieving up to 94% token savings while maintaining full functionality.