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 Providing MCP Services for WeChat Reading</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/介绍-%E5%AE%98%E7%BD%91-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-教程-blue" alt="Experience"></a>
</p>
<hr/>
The WeChat Reading MCP Server is a tool that provides MCP (Model Context Protocol) services for WeChat Reading, supporting the provision of books, notes, and highlighted data from WeChat Reading to large language model clients that support MCP, such as Cursor and Claude Desktop.
## Features
- Retrieve bookshelf information from WeChat Reading (微信读书)
- Search for books in the bookshelf
- Access notes and highlights from books
- Get popular book reviews
- Support organizing notes and highlights by chapters
- Seamless integration with LLM clients that support the MCP protocol
## Main Tools
1. **get_bookshelf** - Retrieve all books on the user's bookshelf
- Returns basic information about the books, including title, author, translator, and category, etc.
2. **search_books** - Search for books on the user's bookshelf by keywords
- Supports fuzzy matching and exact matching
- Optional to include detailed information
- Maximum result count can be set
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 easier understanding by LLM (Large Language Model)
4. **get_book_best_reviews** - Retrieve popular reviews for a specified book
- Supports setting the number of results returned
- Supports pagination
- Includes ratings, number of likes, and reviewer information
## Installation and Usage
### Prerequisites
- Node.js version 16.x or higher
- WeChat Reading account and valid Cookie
### Installation Guide
For details, see:
- [Building a Private Library in Cursor with WeChat Reading MCP, Amazing!](https://mp.weixin.qq.com/s/NQslbUBgWIBMyvTIa3PfYQ)
- [Weread MCP Server User Guide](https://chenge.ink/article/post20250505)
### Integration with Claude Desktop
There are several ways to integrate with Claude Desktop:
#### Method 1: Use via npx (Easiest, Recommended)
1. Open Claude Desktop
2. Go to Settings -> MCP Configuration
3. Add Tool, using the following JSON configuration:
```json
{
"mcpServers": {
"mcp-server-weread": {
"command": "npx",
"args": ["-y", "mcp-server-weread"],
"env": {
// Method 1: Use Cookie Cloud (Recommended)
"CC_URL": "https://cc.chenge.ink", // URL of Cookie Cloud
"CC_ID": "Your ID", // ID of Cookie Cloud
"CC_PASSWORD": "Your Password" // Password of Cookie Cloud
// Or Method 2: Provide Cookie directly
// "WEREAD_COOKIE": "Your WeChat Reading Cookie"
}
}
}
}
```
#### Method 2: Use After Global Installation
1. Global installation package:
```bash
npm install -g mcp-server-weread
```
2. Use in Claude configuration:
```json
{
"mcpServers": {
"mcp-server-weread": {
"command": "mcp-server-weread",
"env": {
// Configure environment variables as above
}
}
}
}
```
> Tip: Providing environment variables directly in the Claude configuration is more convenient, eliminating the need to set up a .env file. It is recommended to use this method.
## CookieCloud Configuration Instructions
To address the issue of frequent Cookie expiration, which requires re-fetching and updating environment variables, this project supports the [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-hosted servers.
### Configuration Steps:
Install the browser extension
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 the CookieCloud Plugin
Server address: Use the default server https://cc.chenge.ink or enter your own server address.
Click "Automatically Generate Password".
Fill in "weread" in the domain keyword for synchronization.
Click "Save", then click "Manual Sync" to ensure the configuration takes effect.
[Optional] If you need the plugin to keep alive automatically, you can fill in https://weread.qq.com for keep-alive, and the plugin will automatically refresh the Cookie.
Configure CookieCloud variables in the 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 the Cookie, and will only use the value of the WEREAD_COOKIE environment variable if it fails to retrieve it.
## Cookie Acquisition Method
The Cookie for WeChat Reading can be obtained through the following steps:
1. Log in to the [WeChat Reading Web Version](https://weread.qq.com/) using the Chrome browser.
2. Press F12 to open the Developer Tools and switch to the Network tab.
3. Refresh the page and find the requests for weread.qq.com in the request list.
4. In the Headers, locate the Cookie field and copy its complete content.
5. Add the copied content to the WEREAD_COOKIE variable in the MCP Json or .env file.
## Usage Examples
Here are some examples of conversations with the LLM:
**Get Bookshelf Information**
```
User: Help me check my WeChat Reading bookshelf.
LLM: I will retrieve your WeChat Reading bookshelf information.
[LLM calls get_bookshelf tool]
I found 208 books on your WeChat Reading bookshelf. Here are some of the books:
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 about psychology.
LLM: I will search for books related to psychology on your bookshelf.
[LLM calls search_books tool with parameter keyword="心理学"]
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 Gerrig (Progress: 30%)
Which book would you like to know more about?
```
**Get Notes and Highlights**
```
User: Help me organize the notes for "Thinking, Fast and Slow."
LLM: I will retrieve the 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 in "Thinking, Fast and Slow" (organized by chapter):
Chapter 1: System 1 and System 2
- Highlight: "System 1 operates automatically and quickly, with little effort and no sense of voluntary control."
- Your note: "System 1 is responsible for intuition and quick judgments, while System 2 is responsible for slow, rational thinking."
Chapter 3: Anchoring Effect
- Highlight: "The anchoring effect refers to the tendency to rely too heavily on the first piece of information encountered when making decisions in uncertain situations."
...
```
**Get Popular Book Reviews**
```
User: What are the popular reviews for "Principles"?
LLM: I will look up the popular reviews for "Principles."
[LLM calls search_books tool to find book ID]
[LLM calls get_book_best_reviews tool]
Here are the popular reviews for "Principles":
1. Reviewer "Thinker" (Rating: 5 stars):
"This is a book about how to think. Dalio summarizes his years of experience into actionable principles that help us make better decisions. I particularly like his view on 'pain + reflection = progress,' which is very practical."
👍 182 | 💬 23
2. Reviewer "Investment Learner" (Rating: 4 stars):
"The essence of the founder of Bridgewater Associates, worth reading repeatedly. The section on work principles is especially helpful for managers; I recommend reading life principles first, then work principles."
👍 94 | 💬 12
...
```
## IX. Links
- [mcp-server-weread](https://github.com/ChenyqThu/mcp-server-weread): 🚀 A tool that provides MCP (Model Context Protocol) services for WeChat Reading, supporting the provision of books, notes, and highlighted data from WeChat Reading to large language model clients that support MCP, such as Claude Desktop.
- [CodeCanvas](https://github.com/freestylefly/CodeCanvas): 📚 This code repository is a compilation of the author's learning journey in frontline internet Java development over the years, aiming to provide a clear and detailed learning tutorial, with a focus on writing core Java content. 💪🏻
- [PmHub](https://github.com/laigeoffer/pmhub): 🔥 PmHub is a microservices intelligent project management system based on SpringCloud & LLM. This project aims to help friends quickly master the architecture design and development process of microservices/distributed projects. If you want to secure a satisfactory offer in campus recruitment or social recruitment, PmHub will be a very nice choice.
## X. Acknowledgments
This project is forked from ChenyqThu's [mcp-server-weread](https://github.com/ChenyqThu/mcp-server-weread) project, with some minor modifications. It suddenly became popular, so please go star the original project on the author's GitHub. Additionally, I will synchronize with ChenyqThu's new updates, and the project will continue to keep the usage tutorial updated. Thank you all for your support.
## 11. Star Trend Chart
[](https://star-history.com/#freestylefly/mcp-server-weread&Date)
## 12. Official Account
Search for **苍何** on WeChat or scan the QR code below to follow the original official account of 苍何. Reply with **AI** to discuss AI with over 5000 friends and learn about MCP together.
## XIII. 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
