Readwise Skills

v1.0.0Knowledge & Memorystable

Agent skills for your Readwise and Reader data, powered by the Readwise MCP server/CLI. Triage your inbox, quiz yourself on what you've read, build a personalized now-reading page, and more.

readwise-skillsmcpai-integration
Share:
230
Stars
0
Downloads
0
Weekly
0/5

What is Readwise Skills?

Readwise Skills is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agent skills for your readwise and reader data, powered by the readwise mcp server/cli. triage your inbox, quiz yourself on what you've read, build a personalized now-reading page, and more.

Agent skills for your Readwise and Reader data, powered by the Readwise MCP server/CLI. Triage your inbox, quiz yourself on what you've read, build a personalized now-reading page, and more.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Agent skills for your Readwise and Reader data, powered by t

Use Cases

Triage reading inbox and organize saved articles.
Quiz yourself on knowledge from Readwise and Reader data.
Build personalized reading lists and track learning progress.
readwiseio

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx readwise-skills

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 Readwise Skills

Readwise Skills is a collection of AI agent skills that connect to your Readwise and Reader data, enabling workflows like inbox triage, reading quizzes, personalized 'now reading' page generation, highlight graph visualization, and conversational reading briefings — all powered by the Readwise MCP server or CLI. The skills work with Claude Code, Codex CLI, Cursor, OpenCode, and any other agent that supports the skills pattern, and are designed to turn your personal reading library into an interactive, queryable knowledge base. Avid readers and knowledge workers who use Readwise to capture highlights and manage their reading queue will find the most value here.

Prerequisites

  • A Readwise account (https://readwise.io) with an active subscription
  • Either the Readwise MCP server configured (remote MCP at https://mcp2.readwise.io/mcp) or the Readwise CLI installed (npm i @readwise/cli)
  • Your Readwise API token (available at https://readwise.io/access_token)
  • An MCP-compatible AI agent: Claude Code, Codex CLI, Cursor, or OpenCode
1

Install the Readwise MCP server or CLI

Choose one of two options: connect to the hosted remote MCP server (no local install) or install the Readwise CLI locally. You only need one of these.

# Option 1: Use the remote MCP server (no install needed)
# Add to your MCP client config:
# { "url": "https://mcp2.readwise.io/mcp" }

# Option 2: Install the Readwise CLI
npm i @readwise/cli
2

Install the readwise-skills using npx skills (recommended)

The npx skills installer registers the skills across all your LLM apps (Claude Code, Codex, Cursor, etc.) automatically.

npx skills add readwiseio/readwise-skills
3

Or install manually for Claude Code

Copy the skills directory to your Claude Code skills path. You can install all skills at once or pick individual ones.

git clone https://github.com/readwiseio/readwise-skills.git
cp -r readwise-skills/skills/triage ~/.claude/skills/triage
cp -r readwise-skills/skills/quiz ~/.claude/skills/quiz
cp -r readwise-skills/skills/reader-recap ~/.claude/skills/reader-recap
4

Or install via Claude Code plugin marketplace

For a one-command setup that installs both the MCP server and all skills simultaneously, use the Claude Code plugin marketplace commands.

/plugin marketplace add readwiseio/readwise-skills
/plugin install readwise@readwise-skills
5

Build your reader persona for personalized output

Run the build-persona skill first to generate a reader_persona.md file from your highlights, tags, and history. Other skills like triage and quiz read this file to tailor their output to your interests.

Readwise Skills Examples

Client configuration

Claude Desktop configuration to connect to the Readwise remote MCP server. Replace YOUR_READWISE_TOKEN with your API token from https://readwise.io/access_token.

{
  "mcpServers": {
    "readwise": {
      "url": "https://mcp2.readwise.io/mcp",
      "headers": {
        "Authorization": "Token YOUR_READWISE_TOKEN"
      }
    }
  }
}

Prompts to try

Natural language prompts to use with Claude Code or another AI agent after the Readwise skills and MCP server are set up.

- "Walk me through my Readwise inbox and help me triage each article."
- "Quiz me on the last book I finished in Readwise."
- "Give me a recap of what I've been reading in Reader this week."
- "Generate a 'What I'm Reading' page I can publish on my website."
- "Tell me something surprising about my reading habits based on my highlights."
- "Visualize my highlights as a graph showing connections between ideas."

Troubleshooting Readwise Skills

Skills activate but return 'No Readwise data found' or authentication errors

Verify that the Readwise MCP server is connected and authenticated. For the remote MCP server, check that your Authorization header contains your valid Readwise API token (get it at https://readwise.io/access_token). For the CLI, run 'readwise auth' to log in and confirm 'readwise sync' completes without errors.

Triage and quiz skills produce generic output not tailored to my interests

Run the build-persona skill first to generate a reader_persona.md file. The triage, quiz, and feed-catchup skills read this file to personalize their output based on your reading history, interests, and goals. Without this file, skills fall back to generic behavior.

npx skills command is not found or fails to install

Ensure you have Node.js and npm installed. Run 'npm install -g skills' to install the skills CLI globally if npx is not resolving it. Alternatively, use the manual installation method by cloning the repository and copying skill directories to ~/.claude/skills/ for Claude Code.

Frequently Asked Questions about Readwise Skills

What is Readwise Skills?

Readwise Skills is a Model Context Protocol (MCP) server that agent skills for your readwise and reader data, powered by the readwise mcp server/cli. triage your inbox, quiz yourself on what you've read, build a personalized now-reading page, and more. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Readwise Skills?

Follow the installation instructions on the Readwise Skills GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Readwise Skills?

Readwise Skills works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Readwise Skills free to use?

Yes, Readwise Skills 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": { "readwise-skills": { "command": "npx", "args": ["-y", "readwise-skills"] } } }

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

Read the full setup guide →

Ready to use Readwise Skills?

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