Home / MCP / Reader MCP Server
Provides an MCP bridge to Readwise Reader, enabling document listing, retrieval, and updates via MCP clients.
Configuration
View docs{
"mcpServers": {
"reader": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/your/reader/server",
"run",
"main.py"
],
"env": {
"ACCESS_TOKEN": "YOUR_TOKEN"
}
}
}
}You run a Model Context Protocol (MCP) server that connects MCP clients like Claude Desktop or VS Code to your Readwise Reader library. It lets clients list, retrieve, and update documents in Reader, enabling seamless interaction with your personal knowledge repository.
Configure your MCP client to connect to the Reader MCP Server using a local stdio connection. The server runs via a command that loads the server script from your project directory and exposes an MCP interface to your client. Set the environment variable ACCESS_TOKEN with your Readwise Reader API access token to authorize requests. In your MCP client settings, reference the stdio connection named reader and provide the command and arguments shown below. This setup lets you list documents, fetch document content, and apply updates from your Readwise Reader library.
Prerequisites: ensure you have the runtime required to execute the MCP server as described here. You will clone the server project, prepare the environment, and run the configured stdio server command.
Step 1: Clone the project directory containing the Reader MCP Server.
Step 2: Open a terminal in the project directory and prepare your environment variable for access tokens.
Step 3: Use your MCP client configuration to run the server locally as shown in the code block below.
{
"mcpServers": {
"reader": {
"type": "stdio",
"name": "reader",
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/your/reader/server",
"run",
"main.py"
],
"env": {
"ACCESS_TOKEN": "your_readwise_access_token"
}
}
}
}- Keep your ACCESS_TOKEN secure. Use a dedicated token with scoped permissions for MCP access. - If you store the token in a file, consider keeping a local .env file in the project directory and referencing it from your client configuration.
If your MCP client cannot connect, verify that the path to the server script is correct, the environment variable ACCESS_TOKEN is set, and the client configuration uses the reader stdio entry. Check that the absolute directory path you provide exists and contains the server script referenced by run main.py.
Lists documents from Readwise Reader with optional filters for location, updatedAfter, content, and pagination. Returns a JSON object with documents and pagination info.