Readwise Enhanced Mcp

Name: Readwise Enhanced Mcp
Author: arnaldo-delisio

@arnaldo-delisio

Repository

About Readwise Enhanced Mcp

No overview available yet

#readwise #mcp #document-management

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

FAQ from Readwise Enhanced Mcp

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.