WeRead
MCP server for weread
What is WeRead?
WeRead is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for weread
MCP server for weread
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for weread
Use Cases
Maintainer
Works with
Installation
NPM
npx -y wereadManual Installation
npx -y wereadConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WeRead
The WeRead MCP Server connects AI assistants to Tencent's WeRead (微信读书) platform, giving users the ability to access their personal bookshelf, search books, retrieve highlights and notes, and browse popular reviews — all through natural language. It authenticates via WeRead session cookies and exposes four focused tools that make reading data available inside any MCP-compatible client. Readers who annotate books heavily in WeRead can use this server to query their highlights, summarize chapters, or export notes into other tools without leaving their AI assistant.
Prerequisites
- Node.js 18 or later installed
- A WeRead (微信读书) account with an active session cookie, or a CookieCloud instance for automatic cookie sync
- An MCP-compatible client such as Claude Desktop
Obtain your WeRead session cookie
Log in to WeRead in your browser, open DevTools (F12), go to the Application tab, and copy the full cookie string from the weread.qq.com domain. Alternatively, set up CookieCloud for automatic sync.
Install the server via npm
The package is published as mcp-server-weread on npm. Install it globally or use npx for on-demand execution.
npm install -g mcp-server-weread
# or run directly without installing:
npx -y mcp-server-wereadConfigure environment variables
Choose one authentication method: direct cookie via WEREAD_COOKIE, or CookieCloud automatic sync via CC_URL, CC_ID, and CC_PASSWORD. CookieCloud takes priority if both are set.
# Option 1: Direct cookie
export WEREAD_COOKIE="vid=...; wr_gid=...; ...full cookie string..."
# Option 2: CookieCloud
export CC_URL=https://cc.chenge.ink
export CC_ID=your-uuid
export CC_PASSWORD=your-passwordAdd the server to your MCP client
Edit your Claude Desktop configuration file to register the WeRead MCP server with your chosen authentication environment variables.
Restart your MCP client and verify
Restart Claude Desktop (or your MCP client) to pick up the new configuration, then ask Claude to list your bookshelf to confirm the connection is working.
WeRead Examples
Client configuration
Add mcp-server-weread to Claude Desktop using a direct WeRead cookie for authentication.
{
"mcpServers": {
"mcp-server-weread": {
"command": "npx",
"args": ["-y", "mcp-server-weread"],
"env": {
"WEREAD_COOKIE": "your_full_weread_cookie_string"
}
}
}
}Prompts to try
Ask Claude to interact with your WeRead library using natural language.
- "Show me all the books on my WeRead bookshelf"
- "Search my WeRead library for books about system design"
- "Get all my highlights and notes from Atomic Habits"
- "What are the most popular reviews for the book I'm currently reading?"Troubleshooting WeRead
Authentication fails with an invalid cookie error
WeRead session cookies expire. Log back in to WeRead in your browser and copy a fresh cookie string. If using CookieCloud, trigger a manual sync to refresh the stored cookies.
get_book_notes_and_highlights returns empty results
Ensure you have actually highlighted or annotated the book in the WeRead app. The tool only returns content you have personally marked — it does not return the full book text.
Server fails to start with MODULE_NOT_FOUND error
Run `npx -y mcp-server-weread` instead of the global install to ensure the correct package name is used. The npm package is mcp-server-weread, not weread.
Frequently Asked Questions about WeRead
What is WeRead?
WeRead is a Model Context Protocol (MCP) server that mcp server for weread It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WeRead?
Install via npm with the command: npx -y weread. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with WeRead?
WeRead works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WeRead free to use?
Yes, WeRead is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
WeRead Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to WeRead? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up WeRead in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use WeRead?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.