WeRead

v1.0.0Knowledge & Memorystable

MCP server for weread

wereadmcpai-integration
Share:
168
Stars
0
Downloads
0
Weekly
0/5

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

Access WeRead books and reading content through MCP.
ChenyqThu

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y weread

Manual Installation

npx -y weread

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

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
1

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.

2

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-weread
3

Configure 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-password
4

Add the server to your MCP client

Edit your Claude Desktop configuration file to register the WeRead MCP server with your chosen authentication environment variables.

5

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.

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.

Quick Config Preview

{ "mcpServers": { "weread": { "command": "npx", "args": ["-y", "weread"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides