weread-mcp

# WeRead MCP Server MCP server for [WeRead](https://weread.qq.com) with SQLite caching. - Sync bookshelf, highlights, thoughts from WeRead API - Local SQLite cache with TTL-based refresh - 14 tools: bookshelf, book info, highlights, search, export, etc. ## Quick Start ### 1. Get Cookie 1. Open https://weread.qq.com and login 2. F12 → Application → Cookies → weread.qq.com 3. Copy cookie string **Required cookie fields:** | Field | Description | Example | |-------|-------------|---------| | `wr_vid` | User ID | `12345678` | | `wr_skey` | Session key, expires in ~2h | `AbcdEfg` | | `wr_rt` | Auth token | `web@xxx...` | Full cookie format: `wr_vid=xxx; wr_skey=xxx; wr_rt=xxx; ...` ### 2. Configure MCP ```json { "mcpServers": { "weread": { "command": "weread-mcp", "env": { "WEREAD_COOKIE": "wr_vid=xxx; wr_skey=xxx; wr_rt=xxx; ...", "WEREAD_DATA_DIR": "~/.weread", "WEREAD_CACHE_TTL": "300" } } } } ``` **Environment variables:** | Variable | Required | Default | Description | |----------|----------|---------|-------------| | `WEREAD_COOKIE` | Yes | - | Cookie string from browser | | `WEREAD_DATA_DIR` | No | `~/.weread` | Cache directory path | | `WEREAD_CACHE_TTL` | No | `300` | Cache TTL in seconds | ## Tools | Tool | Description | |------|-------------| | `get_bookshelf` | List all books | | `get_book_info` | Book details | | `get_book_chapters` | Table of contents | | `get_book_bookmarks` | Highlights | | `get_book_reviews` | Thoughts | | `get_book_notes` | Export as Markdown | | `get_reading_progress` | Progress % | | `get_finished_books` | Completed books | | `get_notebooks` | Books with notes | | `search_books` | Search by title/author | | `search_notes` | Search highlights | | `sync_shelf` | Force sync | | `sync_all_bookmarks` | Sync all highlights | | `get_cache_stats` | Cache info | All tools support `force` param to bypass cache. ## Disclaimer ⚠️ **For educational and personal use only.** - Comply with Tencent ToS and WeRead User Agreement - Do not use for commercial purposes - Do not share your cookie - Authors not responsible for misuse ## License MIT