Readwise MCP

How to use the Readwise MCP tools — access highlights, documents, and your entire reading library via MCP

329 stars 14 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add readwiseio/readwise-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add readwiseio/readwise-skills --skill readwise-mcp
Manual install
git 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-mcp

Personal 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"])
```
Read the full skill on GitHub

Details

Skill name
readwise-mcp
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

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.