The Readwise MCP server allows you to integrate Readwise with LLM clients like Claude to search through your Readwise highlights. You can:
- Connect to your Readwise account
- Perform full-text queries on specific fields such as document_author, document_title, highlight_note, highlight_plaintext, and highlight_tags
- Use vector search to find semantically relevant highlights
Readwise MCP
Overview
The Model Context Protocol (MCP) standardizes how applications provide context to Large Language Models (LLMs), ensuring a clean separation between context management and direct LLM interaction.
This project is a local MCP server designed to act as a bridge between LLM clients (such as Claude) and Readwise.
Installation in Claude
- Please make sure you have Node installed.
- Open Claude desktop app.
- Navigate to Settings > Developer.
- Click
Edit Config
. - Add the following entry to the
claude_desktop_config.json
file, replacingACCESS_TOKEN
value with your Readwise Access Token.
Troubleshooting
For general troubleshooting guidance, please refer to the official Model Context Protocol Claude Desktop Troubleshooting section.
Below are specific solutions to common issues we've encountered and resolved.
"Could not attach to MCP server Readwise MCP"
A very likely reason for this to happen is that you have an incorrect npx/Node version set up. If you're using nvm
, try running nvm use 18
in your terminal. If not, consider reinstalling Node.
Errors when calling Readwise tools
When using this MCP server, you may occasionally encounter MCP errors during your conversations with Claude. If you experience such errors, we recommend trying to switch between different Claude models (e.g., from Claude 3.5 Haiku to Claude 3.7 Sonnet) as this often resolves the issue.
local-only server
The server can only run on the client's local machine because it depends on local resources.
A local Model Context Protocol server that connects LLM clients (like Claude) to Readwise, enabling AI assistants to access and interact with your saved reading content.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.Last updated -220JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.Last updated -JavaScriptMIT License
- -securityAlicense-qualityEnables access and interaction with your Readwise library, allowing you to retrieve and search highlights, books, and documents through natural language queries when using Claude or other MCP-compatible assistants.Last updated -2TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol Server that enables language models to access and manipulate Readwise documents and highlights programmatically.Last updated -2Python