Reader Server MCP Server

@xinthink

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

xinthink

关于 Reader Server MCP Server

Connect your Readwise Reader library to LLMs.

#reader-server#mcp-server#readwise

Reader Server MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "reader-mcp-server-py": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "xinthink/reader-mcp-server",
        "--skill",
        "reader"
      ]
    }
  }
}

Reader Server MCP Server 工具

List documents from Reader with flexible filtering and pagination.

概览

What is Reader Server?

Reader Server is a Model Context Protocol (MCP) server that integrates with your Readwise Reader library. It acts as a bridge between MCP‑compatible clients (such as Claude Desktop and VS Code) and your personal knowledge repository, enabling document listing, retrieval, and updates.

How to use Reader Server?

Add the provided JSON configuration (including the path to the server directory and your Readwise Access Token) to your MCP client settings (e.g., claude_desktop_config.json or .vscode/mcp.json). Alternatively, place the token in a .env file inside the project directory.

Key features of Reader Server

List documents with flexible filtering and pagination.
Optionally retrieve full HTML content of documents.
Supports filters: location (folders like new, later, shortlist, archive, feed) and updatedAfter timestamp.
Pagination via pageCursor for browsing large libraries.
Seamless integration with Claude Desktop and VS Code.
Includes a standalone Reader Skill for direct Readwise API usage.

Use cases of Reader Server

Quickly search and retrieve saved articles from your Reader library.
Automate document organisation by listing and updating entries.
Build note‑taking workflows that pull content from Reader.
Integrate your reading highlights into AI‑powered conversations.

常见问题

What is the difference between Reader Server and the Reader Skill?

The Reader Server is an MCP server that lets MCP clients interact with your Reader library. The Reader Skill is a standalone collection of knowledge and examples for calling the Readwise Reader API directly via HTTP requests, without requiring an MCP server.

What do I need to run Reader Server?

You need a Readwise Reader API access token and the `uv` tool to run the server locally. The server is written in Python and uses `main.py`.

Can I retrieve the full HTML content of my documents?

Yes. When calling the `list_documents` tool, set the `withContent` parameter to `true` to include HTML content in the results.

Where is my data stored?

Your documents remain in Readwise Reader. The server acts only as a bridge—it does not store any data permanently.

How do I authenticate with Readwise Reader?

Provide your Readwise Reader API access token via the `READWISE_ACCESS_TOKEN` environment variable in your MCP client’s configuration or in a `.env` file within the server directory.

其他分类下的更多 MCP 服务器

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.