TypeScript와 공식 Claude SDK를 내장한 Readwise Reader API를 위한 Model Context Protocol (MCP) 서버입니다.

특징

• Secure 인증: 토큰 저장을 위한 환경변수 사용
• 문서 관리: 저장, 목록, 업데이트 및 전체 메타데이터로 문서를 삭제
• Tag Management: 태그로 목록 및 필터
• ** 필터링 **: 위치, 범주, 태그 및 기타 필터 문서
• Pagination Support: 대형 문서 수집 -LLM-Friendly Content: HTML 콘텐츠는 r.jina.ai를 사용하여 텍스트를 자동으로 변환 -Complete Data Access: 콘텐츠, 메타데이터, 타임탬프를 포함한 전체 문서 정보를 반환합니다.

API 문서

Readwise Reader API endpoints, Parameter 및 examples에 대한 자세한 정보는 공식 API 문서 참조:

** 읽지 않은 리더 API 문서**

이 MCP 서버는 공식 문서에 설명된 모든 핵심 엔드포인트를 구현합니다.

설치

구성

Claude 데스크탑

1. MCP 서버 구축:

2. Readwise 액세스 토큰 받기: https://readwise.io/access_token

3. Claude 데스크탑 구성에 서버를 추가합니다.

Readwise Reader MCP Server

A Model Context Protocol (MCP) server for the Readwise Reader API, built with TypeScript and the official Claude SDK.

Features

• Secure Authentication: Uses environment variables for token storage
• Document Management: Save, list, update, and delete documents with complete metadata
• Tag Management: List and filter by tags
• Rich Filtering: Filter documents by location, category, tags, and more
• Pagination Support: Handle large document collections
• LLM-Friendly Content: HTML content automatically converted to clean text using r.jina.ai
• Complete Data Access: Returns full document information including content, metadata, and timestamps

API Documentation

For detailed information about the Readwise Reader API endpoints, parameters, and examples, please refer to the official API documentation:

📖 Readwise Reader API Documentation

This MCP server implements all the core endpoints described in the official documentation.

Installation

npm install
npm run build

Configuration

With Claude Desktop

1. Build the MCP server:

   npm install
   npm run build
   

2. Get your Readwise access token from: https://readwise.io/access_token

3. Add the server to your Claude Desktop configuration. Open your Claude Desktop settings and add this to your MCP servers configuration:

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "readwise-reader": {
         "command": "node",
         "args": ["/path/to/your/reader_readwise_mcp/dist/index.js"],
         "env": {
           "READWISE_TOKEN": "your_readwise_access_token_here"
         }
       }
     }
   }
   

   Replace:

   • /path/to/your/reader_readwise_mcp with the actual path to this project directory
   • your_readwise_access_token_here with your actual Readwise access token

4. Restart Claude Desktop

Available Tools

readwise_save_document

Save a document (URL or HTML content) to Readwise Reader.

Parameters:

• url (required): URL of the document to save
• html (optional): HTML content of the document
• tags (optional): Array of tags to add
• location (optional): Location to save (new, later, shortlist, archive, feed)
• category (optional): Document category (article, book, tweet, pdf, email, youtube, podcast)

readwise_list_documents

List documents from Readwise Reader with optional filtering. Returns complete document information including metadata and LLM-friendly text content.

Parameters:

• id (optional): Filter by specific document ID
• updatedAfter (optional): Filter documents updated after this date (ISO 8601)
• location (optional): Filter by document location
• category (optional): Filter by document category