Overview
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.
