Readwise MCP
How to use the Readwise MCP tools — access highlights, documents, and your entire reading library via MCP
Install
/plugin marketplace add readwiseio/readwise-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add readwiseio/readwise-skills --skill readwise-mcpgit clone --depth 1 https://github.com/readwiseio/readwise-skills.git /tmp/readwise-skills
mkdir -p ~/.claude/skills
cp -r /tmp/readwise-skills/skills/readwise-mcp ~/.claude/skills/readwise-mcpPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Readwise MCP
Use the Readwise MCP tools to access the user's Readwise highlights and Reader documents. Readwise has two products:
- **Readwise** — highlights from books, articles, podcasts, and more. Includes daily review and spaced repetition.
- **Reader** — a read-later app for saving and reading articles, PDFs, EPUBs, RSS feeds, emails, tweets, and videos.
## Setup
Add the Readwise MCP server to your client's configuration:
```json
{
"readwise": {
"type": "http",
"url": "https://mcp2.readwise.io/mcp"
}
}
```
The server handles authentication via OAuth — the user will be prompted to authorize on first use.
## Tool Reference
All tools are prefixed with `mcp__readwise__`. Each tool name maps directly to a Readwise or Reader API action.
## Reader Tools
### Searching documents
```
reader_search_documents(query="spaced repetition")
```
Hybrid search (semantic + keyword) across all saved documents. Combine with filters to narrow results:
```
# Search articles saved for later
reader_search_documents(query="machine learning", category_in=["article"], location_in=["later", "shortlist"])
# Search by author
reader_search_documents(query="AI agents", author_search="Simon Willison")
# Search within a date range
reader_search_documents(query="transformers", published_date_gt="2024-01-01")
# Search by tags
reader_search_documents(query="productivity", tags_in=["research"])
```Details
- Skill name
readwise-mcp- Repository
- readwiseio/readwise-skills
- Path
skills/readwise-mcp/SKILL.md- Repo updated
- 19 June 2026
FAQ
What does the Readwise MCP skill do?
How to use the Readwise MCP tools — access highlights, documents, and your entire reading library via MCP
How do I install the Readwise MCP skill?
Claude Code plugin: /plugin marketplace add readwiseio/readwise-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Readwise MCP popular?
It lives in readwiseio/readwise-skills, which has 329 GitHub stars and 14 forks.
Related skills
Book Review
329readwiseio/readwise-skills
Draft a long-form book review from your Reader highlights — synthesizing the book with your broader reading history to generate original arguments
Build Persona
329readwiseio/readwise-skills
Build a personalized reading profile from your Readwise Reader data, used by triage, quiz, and other skills
Feed Catchup
329readwiseio/readwise-skills
Catch up on your RSS feed — highlights up top, full browse below
Routerbase Model Gateway
492cosmicstack-labs/mercury-agent-skills
Configure RouterBase as an OpenAI compatible model gateway for AI apps, with routing, fallback, media generation, and credential handling patterns.
Prompt Version Management
492cosmicstack-labs/mercury-agent-skills
Manage prompt versions, run A/B tests across agent prompts, track performance regressions, and safely roll out prompt changes in production. Covers prompt diffing, semantic versioning, canary releases, and automated evaluation.
Token Budget Tracking
492cosmicstack-labs/mercury-agent-skills
Track, optimize, and control token consumption across multi-agent systems. Covers budget allocation, real-time monitoring, cost attribution, per-agent limits, and proactive cost optimization for production LLM deployments.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.