reader-mcp-server-py

# Reader MCP Server <a href="https://glama.ai/mcp/servers/@xinthink/reader-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@xinthink/reader-mcp-server/badge" alt="Reader MCP Server" /> </a> ## Overview A Model Context Protocol (MCP) server that seamlessly integrates with your [Readwise Reader](https://readwise.io/reader_api) 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) ```json { "mcpServers": { "reader": { "command": "uv", "args": [ "--directory", "/absolute/path/to/your/reader/server", "run", "main.py" ], "env": { "READWISE_ACCESS_TOKEN": "your-token-here" } } } } ``` - Replace `/absolute/path/to/your/reader/server` with the actual path to this project directory. - Replace `your-token-here` with your actual Readwise Reader API access token. - Alternatively, you can specify the `READWISE_ACCESS_TOKEN` in an `.env` file located in the project directory. --- For more information, see the [Readwise Reader API documentation](https://readwise.io/reader_api) and [MCP documentation](https://modelcontextprotocol.io/). --- ## Reader Skill This repository also includes a standalone skill for interacting with Readwise Reader API directly via HTTP requests. The skill provides knowledge and examples for using the Reader API without requiring an MCP server. ### Features - List, create, update, and delete documents - Full API coverage (list, save, update, delete, tags, bulk operations) - Authentication and rate limit guidance - Code examples in Python ### Installation ```bash npx skills add xinthink/reader-mcp-server --skill reader ``` For more information on installing and using skills, see the [Vercel Labs Skills documentation](https://github.com/vercel-labs/skills). ### Usage Once installed, the skill will be automatically triggered when you ask about Readwise Reader, saving articles, or managing your reading list.