readwise-mcp
The Readwise MCP Server is designed to provide seamless access and interaction with the Readwise library through MCP protocols. It supports features like highlight retrieval, natural language search, and integration with MCP-compatible assistants. The server is crafted for ease of setup, robust error handling, and adherence to protocol standards.
Readwise MCP Server
A Model Context Protocol (MCP) server for accessing and interacting with your Readwise library.
Features
- Access highlights from your Readwise library
- Search for highlights using natural language queries
- Get books and documents from your library
- Seamless integration with Claude and other MCP-compatible assistants
- Enhanced prompt capabilities for highlight analysis
- Transport-aware logging system
- Robust error handling and validation
- MCP protocol compliance with proper request_id handling
- Health check endpoint for monitoring
- Improved setup wizard with API key validation
Project Structure
This repository is organized into key directories such as src/, test-scripts/, examples/, and scripts/.
Installation
Install via npm or clone from the repository; configure with your Readwise API key.
Usage
Start the server with options for stdio or SSE transport and enable debug logging as needed.
Testing
Automated and manual testing options are available, with support for testing without an actual API key.
Tools & Prompts
Various tools and prompts are available, such as get_highlights, get_books, and readwise_search with comprehensive error handling and usability features.