Reader MCP Server

Overview

A Model Context Protocol (MCP) server that seamlessly integrates with your Readwise Reader library. This server enables MCP-compatible clients like Claude and VS Code to interact with your Reader library, providing capabilities for document listing, retrieval, and updates. It serves as a bridge between MCP clients and your personal knowledge repository in Readwise Reader.

Components

Tools

list_documents
- List documents from Reader with flexible filtering and pagination.
- Input:
  - location (string, optional): Folder to filter by. One of new, later, shortlist, archive, feed.
  - updatedAfter (string, optional): Only return documents updated after this ISO8601 timestamp.
  - withContent (boolean, optional): If true, include HTML content in results (default: false).
  - pageCursor (string, optional): Pagination cursor for fetching the next page.
- Returns:
  - JSON object with a list of documents, each including metadata and (optionally) content, plus pagination info.

Usage with MCP Clients

Claude Desktop / VS Code / Other MCP Clients

To use this server with Claude Desktop, VS Code, or any MCP-compatible client, add the following configuration to your client settings (e.g., claude_desktop_config.json or .vscode/mcp.json):

uv (local server)

{
  "mcpServers": {
    "reader": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/reader/server",
        "run",
        "main.py"
      ],
      "env": {
        "ACCESS_TOKEN": "your_readwise_access_token"
      }
    }
  }
}

Replace /absolute/path/to/your/reader/server with the actual path to this project directory.
Replace your_readwise_access_token with your actual Readwise Reader API access token.
Alternatively, you can specify the ACCESS_TOKEN in an .env file located in the project directory.

For more information, see the Readwise Reader API documentation and MCP documentation.