Overview
What is Readwise MCP Server?
A Model Context Protocol (MCP) server for Readwise, allowing AI assistants like Claude to access your saved articles, books, highlights, and documents.
How to use Readwise MCP Server?
Install via npm (npm install -g readwise-mcp) or clone and build. Obtain a Readwise API token from your account settings. Configure it with npm run setup or by passing --api-key YOUR_API_KEY at startup. Docker and Smithery automatic installation are also supported.
Key features of Readwise MCP Server
- Browse your collection of saved books and articles
- Access all highlighted passages with filtering
- Full-text search across your entire Readwise library
- Tag management: add, remove, and bulk tag documents
- Reading progress tracking with status updates
- Video support including timestamps and transcripts
Use cases of Readwise MCP Server
- Ask an AI assistant to find highlights about a specific topic
- Search your Readwise library by author, date, tags, or title
- Save new articles or videos directly from a chat interface
- Manage your reading list: mark progress, delete old items
- Bulk-tag multiple documents to reorganize your library
FAQ from Readwise MCP Server
What runtime does Readwise MCP Server require?
It requires Node.js. Install the npm package globally and run it with readwise-mcp.
How do I authenticate with the server?
Generate a Readwise API token at https://readwise.io/access_token and pass it via the READWISE_API_KEY environment variable or the --api-key CLI flag.
What transport methods are supported?
The server supports both stdio (for Claude Desktop) and SSE (for web) transports.
Does it handle API rate limiting automatically?
Yes, the server includes smart rate‑limiting handling to prevent throttling by the Readwise API.
Where is my data stored?
Your data remains in your Readwise account. The server only accesses it through the official Readwise API; no local copies are kept.
