reader-mcp-server

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.