MCPgee
MCPgee
MCPgeeMCPgee

Readwise Reader

v1.0.0•Knowledge & Memory•stable

Connect your Readwise Reader library to LLMs.

mcp-serverskills
Share:
11
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Readwise Reader?

Readwise Reader is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to connect your readwise reader library to llms.

Connect your Readwise Reader library to LLMs.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Connect your Readwise Reader library to LLMs.

Use Cases

Connect your Readwise Reader library to AI agents for knowledge synthesis.
Access your reading library and annotations through LLMs.
xinthink

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMar 26, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx reader

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Readwise Reader

The Readwise Reader MCP server is a Python-based server that connects your Readwise Reader library to MCP-compatible clients such as Claude Desktop and VS Code. It exposes a list_documents tool with filtering by folder and date, and supports pagination—letting you ask Claude to summarize articles, surface recently saved content, or query your reading list by location (inbox, later, shortlist, archive, or feed) directly in conversation.

Prerequisites

  • A Readwise Reader account with API access enabled
  • A Readwise Reader API access token (available at readwise.io/access_token)
  • uv package manager installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
  • An MCP-compatible client such as Claude Desktop or VS Code with MCP extension
1

Clone the repository

Clone the reader-mcp-server repository to your local machine.

git clone https://github.com/xinthink/reader-mcp-server.git
cd reader-mcp-server
2

Obtain your Readwise Reader API token

Log into your Readwise account and navigate to readwise.io/access_token to generate or copy your personal API access token.

3

Set the API token as an environment variable

Export the token so the server can authenticate with the Readwise Reader API. You can also place it in a .env file in the project directory.

export READWISE_ACCESS_TOKEN=your_readwise_token_here
# Or create a .env file:
echo 'READWISE_ACCESS_TOKEN=your_readwise_token_here' > .env
4

Add to Claude Desktop configuration

Register the server in your Claude Desktop config file using uv to run the server. Use the absolute path to the cloned directory.

{
  "mcpServers": {
    "reader": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/reader-mcp-server", "reader-mcp-server"],
      "env": {
        "READWISE_ACCESS_TOKEN": "your_readwise_token_here"
      }
    }
  }
}
5

Restart Claude Desktop and verify

Restart Claude Desktop and ask Claude to list your most recently saved Reader documents to confirm the connection.

Readwise Reader Examples

Client configuration

Claude Desktop configuration for the Readwise Reader MCP server using uv.

{
  "mcpServers": {
    "reader": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/reader-mcp-server", "reader-mcp-server"],
      "env": {
        "READWISE_ACCESS_TOKEN": "your_readwise_token_here"
      }
    }
  }
}

Prompts to try

Natural-language prompts for exploring your Readwise Reader library.

- "List the 10 most recently saved articles in my Readwise Reader inbox"
- "Show me everything I saved to my shortlist this week"
- "Summarize the articles I archived in the past 3 days"
- "What articles do I have saved in my 'later' folder?"
- "Find documents I saved after 2026-06-01 and include their full content"

Troubleshooting Readwise Reader

Authentication error or empty document list

Verify your READWISE_ACCESS_TOKEN is correct by testing it directly: 'curl -H "Authorization: Token your_token" https://readwise.io/api/v3/list/'. If you get a 401, regenerate the token at readwise.io/access_token.

uv command not found when starting the server

Install uv by running: 'curl -LsSf https://astral.sh/uv/install.sh | sh' and then open a new terminal session. Verify with 'uv --version'. On macOS you may also install via Homebrew: 'brew install uv'.

Claude Desktop cannot find the server directory

Ensure the '--directory' argument in the config uses an absolute path, not a relative one. Use 'pwd' in the cloned directory to get the absolute path and paste it into the config.

Frequently Asked Questions about Readwise Reader

What is Readwise Reader?

Readwise Reader is a Model Context Protocol (MCP) server that connect your readwise reader library to llms. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Readwise Reader?

Follow the installation instructions on the Readwise Reader GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Readwise Reader?

Readwise Reader works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Readwise Reader free to use?

Yes, Readwise Reader is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Readwise Reader Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Readwise Reader? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "reader": { "command": "npx", "args": ["-y", "reader"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Readwise Reader?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides