Reader

Provides an MCP bridge to Readwise Reader enabling clients to list, retrieve, and update documents.

python

11

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a Model Context Protocol (MCP) server that bridges your Readwise Reader library to MCP clients like Claude or VS Code, enabling you to list, retrieve, and update documents through familiar MCP tooling.

How to use

You connect an MCP client to your local Reader MCP Server by configuring the client to load an MCP server that runs locally. Once connected, you can browse your Reader documents, fetch document details, and push updates or new documents using standard MCP interactions. The server exposes a list_documents tool that supports filtering, pagination, and optional content inclusion so you can tailor responses to your needs.

How to install

Prerequisites: you need Python installed to run the server runtime, plus an MCP-capable client for testing, such as Claude Desktop or VS Code.

Prepare a directory for the Reader MCP Server and place the server code there.
Start the MCP runtime locally using the provided command example, which runs the Python entry point and points to your server directory.
Configure your MCP client to connect to the local server using the details shown in the configuration example below.

Additional configuration and notes

The server uses an access token to authenticate with Readwise Reader. You can provide the token through an environment variable or a dedicated config file as shown in the example configuration.

The Reader MCP Server exposes a single stdio client configuration named reader. You can run it locally with the following command structure and environment variable.

If you are using an MCP client with a local runtime, you can pass your token securely via an environment file or directly in the configuration.

MCP server connection example

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

Available tools

list_documents

Lists Reader documents with optional location filtering (new, later, shortlist, archive, feed), updatedAfter timestamp filtering, optional content inclusion, and pagination via pageCursor.