Content
<p align="center"><img src= "https://cdn.canghecode.com/blog/%E5%BE%AE%E4%BF%A1%E8%AF%BB%E4%B9%A6MCP%20bac.png" alt="MaxKB" width="300" /></p>
<h3 align="center">A Tool for WeRead MCP Service</h3>
<p align="center">
<a href="https://opensource.org/license/MIT"><img src="https://img.shields.io/github/license/freestylefly/mcp-server-weread?color=rgb(25%2C%20121%2C%20255)" alt="The MIT License"></a>
<a href=""><img src="https://img.shields.io/github/forks/freestylefly/mcp-server-weread?color=green" alt="Forks"></a>
<a href="https://canghecode.com/"><img src="https://img.shields.io/badge/Introduction-Official%20Website-green" alt="Official"></a>
<a href="https://github.com/laigeoffer/pmhub"><img src="https://img.shields.io/github/stars/freestylefly/mcp-server-weread?style=flat-square&color=rgb(25%2C%20121%2C%20255)" alt="Stars"></a>
<a href="https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ"><img src="https://img.shields.io/badge/WeReadMCP-Tutorial-blue" alt="Experience"></a>
</p>
<hr/>
WeRead MCP Server is a tool that provides MCP (Model Context Protocol) service for WeRead, supporting large language model clients that support MCP, such as Cursor and Claude Desktop.
## Features
- Retrieve bookshelf information from WeRead
- Search for books on the bookshelf
- Get notes and highlights for a book
- Get popular reviews for a book
- Support organizing notes and highlights by chapter
- Seamless integration with MCP protocol-supported LLM clients
## Main Tools
1. **get_bookshelf** - Retrieve all books on the user's bookshelf
- Returns basic book information, including title, author, translator, and category
2. **search_books** - Search for books on the bookshelf by keyword
- Supports fuzzy matching and exact matching
- Optional detailed information
- Configurable maximum result count
3. **get_book_notes_and_highlights** - Retrieve all highlights and notes for a specified book
- Supports organizing results by chapter
- Supports filtering highlight styles
- Returns structured data for easy understanding by LLM
4. **get_book_best_reviews** - Retrieve popular reviews for a specified book
- Supports setting the number of returned reviews
- Supports pagination
- Includes rating, like count, and reviewer information
## Installation and Usage
### Prerequisites
- Node.js 16.x or higher
- WeRead account with a valid Cookie
### Installation Tutorial
See:
- [Using WeRead MCP in Cursor to Build a Private Library](https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ)
- [Weread MCP Server User Guide](https://chenge.ink/article/post20250505)
### Integration with Claude Desktop
There are multiple ways to integrate with Claude Desktop:
#### Method 1: Using npx (recommended)
1. Open Claude Desktop
2. Go to Settings -> MCP Configuration
3. Add a tool with the following JSON configuration:
```json
{
"mcpServers": {
"mcp-server-weread": {
"command": "npx",
"args": ["-y", "mcp-server-weread"],
"env": {
// Method 1: Using Cookie Cloud (recommended)
"CC_URL": "https://cc.chenge.ink", // Cookie Cloud URL
"CC_ID": "Your ID", // Cookie Cloud ID
"CC_PASSWORD": "Your Password" // Cookie Cloud Password
// Or Method 2: Providing Cookie directly
// "WEREAD_COOKIE": "Your WeRead Cookie"
}
}
}
}
```
#### Method 2: Using global installation
1. Globally install the package:
```bash
npm install -g mcp-server-weread
```
2. Configure in Claude:
```json
{
"mcpServers": {
"mcp-server-weread": {
"command": "mcp-server-weread",
"env": {
// Configure environment variables as above
}
}
}
}
```
> Tip: Providing environment variables directly in Claude configuration is more convenient and recommended.
## CookieCloud Configuration
To solve the problem of frequent cookie expiration and the need to re-acquire and update environment variables, this project supports [CookieCloud](https://github.com/easychen/CookieCloud) service to automatically synchronize and update cookies. CookieCloud is an open-source cross-browser cookie synchronization tool that supports self-built servers.
### Configuration Steps:
Install browser plugin
Edge Store: [CookieCloud for Edge](https://microsoftedge.microsoft.com/addons/detail/cookiecloud/bffenpfpjikaeocaihdonmgnjjdpjkeo)
Chrome Store: [CookieCloud for Chrome](https://chromewebstore.google.com/detail/cookiecloud/ffjiejobkoibkjlhjnlgmcnnigeelbdl)
### Configure CookieCloud Plugin
Server address: Use the default server https://cc.chenge.ink or enter your self-built server address
Click "Generate password automatically"
Enter "weread" in the synchronization domain keyword
Click "Save" and then click "Manual synchronization" to ensure the configuration takes effect
[Optional] If you need the plugin to automatically keep alive, you can enter https://weread.qq.com in the keep alive section, and the plugin will automatically refresh the cookie.
Configure CookieCloud variables in MCP JSON:
CC_URL=Your CookieCloud server address (or use my default server address https://cc.chenge.ink)
CC_ID=Your CookieCloud user UUID
CC_PASSWORD=Your CookieCloud password
Note: After configuring CookieCloud, the system will prioritize using CookieCloud to obtain cookies. If it fails to obtain cookies, it will use the value of the WEREAD_COOKIE environment variable.
## Cookie Acquisition Method
WeRead cookies can be obtained through the following steps:
1. Log in to [WeRead web version](https://weread.qq.com/) using Chrome browser
2. Press F12 to open the developer tool, switch to the Network tab
3. Refresh the page, find the request for weread.qq.com in the request list
4. Find the Cookie field in the Headers, copy its complete content
5. Add the copied content to the WEREAD_COOKIE variable in MCP JSON or .env file
## Usage Examples
Here are some examples of dialogue with LLM:
**Get Bookshelf Information**
```
User: Help me view my WeRead bookshelf
LLM: I will retrieve your WeRead bookshelf information.
[LLM calls get_bookshelf tool]
I retrieved 208 books from your WeRead bookshelf. Here are some of them:
1. "The Hidden Self" - David Eagleman
2. "Thinking, Fast and Slow" - Daniel Kahneman
3. "Sapiens: A Brief History of Humankind" - Yuval Noah Harari
...
```
**Search for Specific Books**
```
User: Help me find books related to psychology
LLM: I will search for books related to psychology on your bookshelf.
[LLM calls search_books tool with keyword="psychology"]
I found 3 books related to psychology on your bookshelf:
1. "Thinking, Fast and Slow" - Daniel Kahneman (progress: 75%)
2. "The Crowd: A Study of the Popular Mind" - Gustave Le Bon (progress: 50%)
3. "Psychology and Life" - Richard G. Grigg (progress: 30%)
Which book would you like more information about?
```
**Get Notes and Highlights**
```
User: Help me organize notes for "Thinking, Fast and Slow"
LLM: I will retrieve notes and highlights for "Thinking, Fast and Slow".
[LLM calls search_books tool to find book ID]
[LLM calls get_book_notes_and_highlights tool]
Here are your notes and highlights for "Thinking, Fast and Slow" (organized by chapter):
Chapter 1: Systems 1 and 2
- Highlight: "System 1 operates automatically and quickly, with little or no sense of voluntary control."
- Your note: "System 1 is responsible for intuition and quick judgments, while System 2 is responsible for slow and rational thinking."
Chapter 3: Anchoring Effect
- Highlight: "The anchoring effect refers to the tendency to rely too heavily on an initial piece of information when making decisions under uncertainty."
...
```
**Get Popular Reviews**
```
User: What are some popular reviews for "The Principles"?
LLM: I will retrieve popular reviews for "The Principles".
[LLM calls search_books tool to find book ID]
[LLM calls get_book_best_reviews tool]
Here are some popular reviews for "The Principles":
1. Reviewer "Thinker" (rating: 5 stars):
"This is a book about how to think. Ray Dalio summarizes his years of experience into actionable principles that help us make better decisions. I especially like his point about 'pain + reflection = progress', which is very practical."
👍 182 | 💬 23
2. Reviewer "Investment Learner" (rating: 4 stars):
"The founder of Bridgewater Fund's thoughts, worth reading repeatedly. The life principles section is particularly helpful for managers, and I recommend reading life principles before work principles."
👍 94 | 💬 12
...
```
## Nine. Friend Links
- [mcp-server-weread](https://github.com/ChenyqThu/mcp-server-weread) ：🚀A tool that provides MCP (Model Context Protocol) service for WeRead, supporting large language model clients that support MCP, such as Claude Desktop.
- [CodeCanvas](https://github.com/freestylefly/CodeCanvas) ：📚This code repository is a collection of technical summaries and learning experiences from the author, Cang He, during his years of working as a Java developer.
- [PmHub](https://github.com/laigeoffer/pmhub) ：🔥PmHub is a microservice-based intelligent project management system using SpringCloud & LLM.
## Ten. Acknowledgements
This project was forked from ChenyqThu's [mcp-server-weread](https://github.com/ChenyqThu/mcp-server-weread) project, with some minor modifications. Please star the original project on GitHub, and I will also synchronize updates from ChenyqThu.
## Eleven. Star Trend Chart
[](https://star-history.com/#freestylefly/mcp-server-weread&Date)
## Twelve. Official Account
Search for **Cang He** on WeChat or scan the QR code below to follow my original official account. Reply **AI** to discuss AI and learn MCP with over 5,000 friends.
## Thirteen. License
[MIT License (MIT)](https://opensource.org/licenses/MIT)<hr/>
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
Copyright (c) 2025-2026 mcp-server-weread
