MCP Servers

readwise-reader-mcp

Enables integration with Readwise Reader API to save, retrieve, update, and manage documents, tags, and filtering in your Readwise Reader account.

README

Readwise Reader MCP Server

A Model Context Protocol (MCP) server for integrating with Readwise Reader API. This server provides tools for saving, retrieving, updating, and managing documents in your Readwise Reader account.

Features

🔐 Authentication: Secure token-based authentication with Readwise Reader
📚 Document Management: Save, list, update, and delete documents
🏷️ Tag Management: List and organize your tags
🔍 Advanced Filtering: Filter documents by location, category, tags, and dates
🌐 HTTP Transport: Streamable HTTP server for easy integration
🐳 Docker Support: Containerized deployment ready

Available Tools

readwise_authenticate - Authenticate with Readwise Reader API
readwise_save_document - Save a new document (URL or HTML content)
readwise_list_documents - List documents with filters
readwise_update_document - Update document metadata
readwise_delete_document - Delete a document
readwise_list_tags - List all available tags
readwise_get_document_content - Get full content of a specific document

Quick Start

Prerequisites

Python 3.9+ installed
Readwise Account with Reader access
Access Token from https://readwise.io/access_token

Installation

# Clone the repository
git clone <repository-url>
cd readwise-reader-mcp

# Install the package
pip install -e .

Configuration

Copy the example environment file:

cp .env.example .env

Edit .env and add your Readwise access token:

READWISE_ACCESS_TOKEN=your_token_here

Running the Server

Local Development

# Run with default settings (port 8000)
readwise-reader-mcp

# Run on custom port
readwise-reader-mcp --port 9000

# Show help
readwise-reader-mcp --help

Using Docker

Build and run with Docker:

# Build the image
docker build -t readwise-reader-mcp .

# Run with environment file
docker run -p 8000:8000 --env-file .env readwise-reader-mcp

# Or run with inline environment variable
docker run -p 8000:8000 -e READWISE_ACCESS_TOKEN=your_token readwise-reader-mcp

Docker Compose

version: '3.8'
services:
  readwise-reader-mcp:
    build: .
    ports:
      - "8000:8000"
    environment:
      - READWISE_ACCESS_TOKEN=your_token_here
      - LOG_LEVEL=INFO

Integration with Claude Desktop

Add this configuration to your Claude Desktop settings:

{
  "mcpServers": {
    "readwise-reader": {
      "command": "readwise-reader-mcp",
      "args": ["--port", "8000"],
      "env": {
        "READWISE_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Or use WebSocket connection:

{
  "mcpServers": {
    "readwise-reader": {
      "command": "ws://localhost:8000/ws"
    }
  }
}

API Usage Examples

Save a Document

# Save a web page by URL
readwise_save_document({
    "url": "https://example.com/article",
    "title": "Interesting Article",
    "tags": ["tech", "ai"],
    "location": "later"
})

# Save HTML content directly
readwise_save_document({
    "html": "<html><body><h1>My Article</h1>...</body></html>",
    "title": "Custom Content",
    "category": "article"
})

List Documents

# List recent documents
readwise_list_documents()

# Filter by location
readwise_list_documents({
    "location": "archive",
    "category": "article"
})

# Get documents updated after a date
readwise_list_documents({
    "updated_after": "2024-01-01T00:00:00Z"
})

Update Document

readwise_update_document({
    "document_id": "doc_id_here",
    "title": "New Title",
    "location": "archive"
})

Document Locations

new - New/Inbox (default for saved documents)
later - Read Later list
shortlist - Shortlist
archive - Archived documents

Rate Limits

The Readwise Reader API has the following rate limits:

General requests: 20 requests per minute
Document saves/updates: 50 requests per minute

The client automatically handles rate limit errors and includes appropriate retry information.

Error Handling

The server provides detailed error responses:

{
  "success": false,
  "error": "Authentication failed: Invalid token"
}

Common errors:

Authentication errors: Invalid or expired token
Rate limiting: Too many requests
Validation errors: Missing required parameters
API errors: Readwise service issues

Development

Setup Development Environment

# Install with development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/

# Lint code
ruff check src/

Project Structure

readwise-reader-mcp/
├── src/
│   └── readwise_reader_mcp/
│       ├── __init__.py
│       ├── client.py          # Readwise API client
│       ├── models.py          # Pydantic models
│       └── server.py          # FastMCP server
├── tests/                     # Test files
├── Dockerfile                 # Container configuration
├── pyproject.toml            # Project configuration
├── .env.example              # Environment template
└── README.md

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Run the test suite
Submit a pull request

License

MIT License - see LICENSE file for details.

Support

Issues: GitHub Issues
Readwise API Documentation: https://readwise.io/reader_api
MCP Documentation: Model Context Protocol

Changelog

0.1.0

Initial release
Basic document management tools
HTTP transport support
Docker containerization
Authentication and error handling

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured

readwise-reader-mcp

README

Readwise Reader MCP Server

Features

Available Tools

Quick Start

Prerequisites

Installation

Configuration

Running the Server

Local Development

Using Docker

Docker Compose

Integration with Claude Desktop

API Usage Examples

Save a Document

List Documents

Update Document

Document Locations

Document Categories

Rate Limits

Error Handling

Development

Setup Development Environment

Project Structure

Contributing

License

Support

Changelog

0.1.0

Recommended Servers