Readwise MCP Server 📚
Connect your Readwise account to Claude AI and access all your highlights, books, and reading list directly in conversations!
✨ What Can You Do?
Once set up, you can ask Claude:
- "What's in my Readwise reading list?" - View all saved articles
- "Show me my daily review highlights" - Get your spaced repetition review
- "Search my highlights for 'productivity tips'" - Find specific highlights
- "Save this article: https://example.com" - Add to your reading list
- "List all my tags" - See your document tags
- "Export all my highlights" - Backup your entire library
🚀 10-Minute Setup
What You Need
- ✅ Readwise account (Get one here)
- ✅ Claude AI (Pro/Team/Enterprise - any plan with MCP support)
- ✅ Free Render account for hosting
Step 1: Get Your Readwise Token (1 min)
- Go to https://readwise.io/access_token
- Copy your access token
- Keep it handy
Step 2: Fork & Deploy Server (5 min)
Option A: Deploy to Render (Recommended)
-
Fork this repository:
- Click "Fork" button at the top of this GitHub page
- This creates your own copy of the code
-
Sign up at Render (free tier available)
-
Create New Web Service:
- Click "New +" → "Web Service"
- Choose "Connect a Git repository"
- Select your forked repository from the list
-
Configure:
- Name:
readwise-mcp(or your choice) - Runtime: Docker (auto-detected)
- Plan: Free
- Name:
-
Add Environment Variable (in Render dashboard):
READWISE_TOKEN=<paste_your_token_from_step_1>
That's it! No API key needed.
-
Click Create Web Service and wait ~2 minutes
Option B: Other Platforms
Railway / Fly.io / Google Cloud Run
The server works on any platform that supports Docker. See Dockerfile for configuration.
Step 3: Verify It's Running (1 min)
Visit: https://YOUR-SERVICE-NAME.onrender.com/health
You should see:
{
"status": "healthy",
"service": "readwise-mcp-enhanced",
"authentication": "enabled"
}
✅ If you see this, you're good to go!
Step 4: Connect to Claude (3 min)
-
Open Claude AI at https://claude.ai
-
Go to Settings → Integrations (or similar MCP section)
-
Add MCP Server:
Name: Readwise URL: https://YOUR-SERVICE-NAME.onrender.comNo API key needed!
-
Test Connection - Should show "12 tools available"
-
Save and you're done! 🎉
Step 5: Start Using!
Try asking Claude:
- "What did I save to Readwise today?"
- "Show me highlights from my AI books"
- "Get my daily review"
📖 All Available Features
Reader Tools (5 tools)
- Save documents - Add URLs to your reading list
- List documents - Browse with filters (location, category, author, date)
- Update documents - Edit titles, tags, notes
- Delete documents - Remove from library
- List tags - View all your tags
Highlights Tools (7 tools)
- List highlights - Browse with date filters
- Daily review - Spaced repetition system
- Search highlights - Find by text query using enhanced MCP endpoint with vector/semantic search
- List books - View books with highlight counts
- Get book highlights - All highlights from a specific book
- Export highlights - Backup everything
- Create highlights - Add manual highlights
🚀 Advanced Features
- ✅ Enhanced MCP Search - Uses Readwise's MCP endpoint with vector/semantic search for better results
- ✅ Unlimited pagination - Fetch ALL your data
- ✅ Incremental sync - Get only new/updated items
- ✅ Smart filtering - Filter by author, site, dates
- ✅ Bulk export - Backup your entire library
🆓 Cost
100% Free for Personal Use:
- ✅ Render: 750 hours/month (runs 24/7)
- ✅ Uses your existing Readwise subscription
- ⚠️ Server "sleeps" after 15 min (10 sec wake-up on first request)
Optional Upgrade:
- 💵 $7/month for Render Starter (always-on, no sleep)
🛠️ Troubleshooting
"Connection Failed" in Claude
- Visit
https://YOUR-SERVICE.onrender.com/health- Should return healthy status - Verify the URL is correct in Claude settings
- Wait 10 seconds if server was sleeping (free tier)
Server Takes Long to Respond
- Free tier "sleeps" after 15 min inactivity
- First request after sleep takes ~10 seconds to wake up
- This is normal - subsequent requests are fast!
"Readwise API Error"
- Check your
READWISE_TOKENin Render dashboard - Verify token at https://readwise.io/access_token
- Token might have expired - get a new one
Still Need Help?
- 📖 See CLAUDE_AI_SETUP.md for detailed Claude setup
- 🚀 See DEPLOYMENT.md for advanced deployment options
- 🐛 Open an issue
🔒 Security & Privacy
- ✅ All requests encrypted via HTTPS
- ✅ Your Readwise token stays on your server (never exposed to Claude)
- ✅ Open source - inspect the code yourself!
- ⚠️ Important: Your server URL is public but only works with YOUR Readwise token
Keep your secrets safe:
- Never commit
.envfiles with tokens - Don't share your Readwise token
- Only you can access your data through your server
🧪 For Developers
Run Locally
# Install dependencies
pip install -r requirements.txt
# Configure
cp .env.example .env
# Edit .env with your tokens
# Run
python main.py
# Test
python test_all_tools.py
Docker
docker build -t readwise-mcp .
docker run -p 8000:8000 \
-e READWISE_TOKEN=your_token \
readwise-mcp
Project Structure
readwise-mcp-server/
├── main.py # FastMCP server (12 tools with enhanced MCP search)
├── readwise_client.py # Readwise API client (supports MCP endpoints)
├── requirements.txt # Python dependencies
├── Dockerfile # Container config
├── render.yaml # Render deployment
└── test_all_tools.py # Test suite
🤝 Contributing
Contributions welcome! Please:
- Fork the repo
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
🙏 Credits
Built with:
- FastMCP - Python MCP framework
- Readwise API - Readwise platform
- MCP Protocol - Anthropic's protocol
⭐ Support
If you find this useful, please star the repository!
Made with ❤️ for the Readwise and Claude AI community
Metadata
Release files for iflow-mcp_mayankbohra-remote-readwise-mcp 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_mayankbohra_remote_readwise_mcp-1.0.0.tar.gz | 28.5 kB | Without provenance | Details for iflow_mcp_mayankbohra_remote_readwise_mcp-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_mayankbohra_remote_readwise_mcp-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_mayankbohra_remote_readwise_mcp-1.0.0-py3-none-any.whl |
Total release size: 70.7 kB
Release files / iflow_mcp_mayankbohra_remote_readwise_mcp-1.0.0.tar.gz
| Download URL | iflow_mcp_mayankbohra_remote_readwise_mcp-1.0.0.tar.gz |
|---|---|
| Size | 28.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4391162c141d4c66aea400c972527febdd1aa097bc457efdbfbcec5343261f40
|
|
BLAKE2b-256 checksum How to use checksums |
ee361c8b90518de227ec553a4b735fb02842205e1d7b0d1469e34cd2fef7abcb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_mayankbohra_remote_readwise_mcp-1.0.0-py3-none-any.whl
| Download URL | iflow_mcp_mayankbohra_remote_readwise_mcp-1.0.0-py3-none-any.whl |
|---|---|
| Size | 42.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
66b2bd257218201dab8127485fe4605b8e258549cc9de6738ee64e92bf99ecc4
|
|
BLAKE2b-256 checksum How to use checksums |
4860527733621007182b4780bf0d1852ec9dd161af48f656ce0b571f97b37531
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_mayankbohra-remote-readwise-mcp 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.