Integrations
Uses python-dotenv to load environment variables from a .env file, specifically for managing the Readwise API key
Used in the installation process to clone the repository
Mentioned as an example text editor for modifying configuration files
Kiseki-Labs-Readwise-MCP
Overview
Kiseki-Labs-Readwise-MCP
is a Model Context Protocol (MCP) Server designed to interact with the Readwise API.
It allows language models to access and manipulate your Readwise documents and highlights programmatically. This server is developed by Kiseki Labs.
Installation
- Clone the repository:Copy
- Initialise dependencies with uv
(Assuming you have uv installed)Copy
Configuration
This server requires a Readwise API key to function.
- Obtain your API key from Readwise.
- Create a
.env
file in the root directory of the project. - Add your API key to the
.env
file:The server usesCopypython-dotenv
to automatically load this variable when run.
Available Tools
The server exposes the following tools for interaction:
find_readwise_document_by_name(document_name: str) -> Book | None
: Finds a specific document in Readwise by its exact name.list_readwise_documents_by_filters(document_category: str = "", from_date: Optional[date] = None, to_date: Optional[date] = None) -> List[Book]
: Lists documents based on category (e.g., 'books', 'articles') and/or a date range. Requires at least one filter.get_readwise_highlights_by_document_ids(document_ids: List[int]) -> List[Highlight]
: Retrieves all highlights associated with a list of specific document IDs.get_readwise_highlights_by_filters(from_date: Optional[date] = None, to_date: Optional[date] = None, tag_names: List[str] = []) -> List[Highlight]
: Fetches highlights based on a date range and/or a list of tags. Requires at least one filter.
(Note: Book
and Highlight
refer to the data structures defined in the readwise_mcp.types
module.)
Running the Server
Development Mode
To run the MCP server in dev mode, execute the following command from the project's root directory:
The dev server will start and become accessible online by default on http://127.0.0.1:6274/ if you haven't modified the host and port.
Installing the MCP Server with Claude
On MacBook open the file below in your favourite text editor:
For instance using vim open this file you can run the command:
Then add the appropriate entry under the mcpServers
object, like in the example below:
Save the file with those changes.
Finally, restart Claude. After restart, the Kiseki-Labs-Readwise-MCP
MCP Server should be available.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol Server that enables language models to access and manipulate Readwise documents and highlights programmatically.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.Last updated -12PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Large Language Models to seamlessly interact with ClickHouse databases, supporting resource listing, schema retrieval, and query execution.Last updated -1PythonMIT License
Astra DB MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol server that allows Large Language Models to interact with Astra DB databases, providing tools for managing collections and records through natural language commands.Last updated -1011512TypeScriptApache 2.0- -securityAlicense-qualityA Model Context Protocol server that enables Large Language Models to interact with ClickUp workspace tasks and data, allowing creation and retrieval of tasks through natural language.Last updated -59TypeScriptMIT License