Skip to main content
affpapa.org
RU EN
skill CX Codex

readwise-mcp — Claude Code skill: what it does, how to install

This skill connects an agent to Readwise and Reader through MCP for searching documents and highlights. It helps when your reading library needs to be queried from code.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add readwiseio/readwise-skills --skill readwise-mcp -a claude-code
Open on GitHub

What readwise-mcp does

readwise-mcp gives the agent access to Reader documents and Readwise highlights. Its MCP tool descriptions cover semantic and keyword document search, filters for authors, tags, dates, and locations, full document retrieval, highlight creation, and note updates.

The skill also describes document browsing, tagging, metadata edits, moving items, library export to a ZIP of Markdown files, and highlight search. Add the server at https://mcp2.readwise.io/mcp; authorization is handled through OAuth on first use. The tools will not work until that authorization is granted.

What it helps with

  • search saved documents by topic, author, or tag
  • open the full content of a Reader document
  • find highlights related to a subject or book
  • update tags and notes on saved material
  • export the reading library as Markdown files

Example prompts for the agent

  • Search my Reader library for material about agent systems and narrow the results to the research tag.
  • Open the document with ID <id>, select its key passage, and attach a note to it.
  • Find my highlights about learning, then group the results by document title.

How to install readwise-mcp

1Skills CLI (Vercel)

npx skills add readwiseio/readwise-skills --skill readwise-mcp -a claude-code

2Manually: put the files in place

~/.claude/skills/readwise-mcp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/readwise-mcp/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about readwise-mcp

How do I install readwise-mcp in Claude Code?

Run npx skills add readwiseio/readwise-skills --skill readwise-mcp -a claude-code. The skill file is placed at ~/.claude/skills/readwise-mcp/SKILL.md.

What does readwise-mcp do?

It describes how an agent can use Readwise MCP to search and read Reader documents, find highlights, manage tags and notes, edit metadata, and export saved content.

What is required for readwise-mcp to work?

Add the MCP server at https://mcp2.readwise.io/mcp to the client configuration. Readwise then asks for OAuth authorization on the first use.

Similar skills

All skills for Agent setup: memory, context, orchestration →
setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set11

book-review This skill generates a long-form book review by connecting the book's core ideas to your Readwise library. Use it when you want a review that goes beyond one book and draws on your entire reading history. CX Codex +1 589installs reader-recap Generates a conversational digest of recent Readwise Reader activity, covering archived texts, highlights, and notes. It pulls out questions and follow-ups. CX Codex +1 507installs feed-catchup Cleans up your unread Readwise Reader RSS feed, highlights the five best articles, and lets you triage the rest in batches. CX Codex +1 501installs build-persona This skill turns your Readwise Reader library into a reader_persona.md profile so triage, quiz and other skills can tailor their output to you. CX Codex +1 492installs triage The skill walks you through recent Readwise Reader saves one at a time and argues each case for and against reading. Handy when the inbox has piled up and you don't know where to start. CX Codex +1 470installs now-reading-page Turns your Readwise Reader library into a single HTML page showing what you are reading now and what you finished recently. CX Codex +1 455installs surprise-me The skill digs through your Readwise highlights and saved documents to surface one surprising thing about you as a reader. CX Codex +1 445installs highlight-graph Turns your Readwise highlights into an interactive graph so you can see which ideas from different books and articles connect. CX Codex +1 443installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor