Kiseki-Labs-Readwise-MCP

Name: Kiseki-Labs-Readwise-MCP
Author: kiseki-technologies

@kiseki-technologies

代码仓库

关于 Kiseki-Labs-Readwise-MCP

A simple MCP server for Readwise

基本信息

分类

其他

运行时

python

传输方式

stdio

发布者

kiseki-technologies

配置

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

{
  "mcpServers": {
    "kiseki-labs-readwise-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Kiseki-Labs-Readwise-MCP?

Kiseki-Labs-Readwise-MCP is a Model Context Protocol (MCP) server that interacts with the Readwise API, enabling language models to access and manipulate Readwise documents and highlights programmatically. It is developed by Kiseki Labs.

How to use Kiseki-Labs-Readwise-MCP?

Clone the repository, initialize dependencies with uv sync, and create a .env file with your READWISE_API_KEY from Readwise. Run the server in development mode using uv run mcp dev server.py from the project root. For integration with Claude, add the appropriate entry to ~/Library/Application Support/Claude/claude_desktop_config.json.

Key features of Kiseki-Labs-Readwise-MCP

Finds documents in Readwise by exact name.
Lists documents filtered by category and/or date range.
Retrieves highlights for specific document IDs.
Fetches highlights filtered by date range and/or tags.

Use cases of Kiseki-Labs-Readwise-MCP

Query a language model to find a specific document and retrieve its highlights.
Aggregate recent highlights from a selected time period or tag set.
Programmatically organize reading materials by category (e.g., books, articles).

FAQ from Kiseki-Labs-Readwise-MCP

What is required to use this server?

A Readwise API key is required. Obtain it from https://readwise.io/access_token and store it in a .env file as READWISE_API_KEY.

How do I run the server in development mode?

Run uv run mcp dev server.py from the project root directory. The server will start on http://127.0.0.1:6274 by default.

What tools does the server expose?

Four tools: find_readwise_document_by_name, list_readwise_documents_by_filters, get_readwise_highlights_by_document_ids, and get_readwise_highlights_by_filters.

How do I integrate this server with Claude?

Open the Claude desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json and add an entry under mcpServers with the appropriate uv run command, then restart Claude.

Does the server require any other dependencies?

Yes, the repository uses uv for dependency management and python-dotenv to load environment variables. The uv sync command installs all required packages.