readwise-api

Fetch Readwise activity data across date ranges and output analysis modes.

4|Updated Oct 6, 2025
One-click install
npx skills add https://github.com/otrebu/agents --skill readwise-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: readwise-api
Source: https://github.com/otrebu/agents/tree/main/plugins/knowledge-work/skills/readwise-api
Command: npx skills add https://github.com/otrebu/agents --skill readwise-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chalk, ora, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Connects to Readwise v2/v3 APIs to fetch highlights, articles, and activity for customizable date ranges, then analyzes and presents results.

Core Features & Use Cases

  • Date Range Flexibility: Presets (today, yesterday, last-week, last-month) or custom ranges.
  • Comprehensive Output: Key learnings, activity timeline, category breakdown, and stats dashboard.
  • Legacy Modes: Access articles, highlights, and top highlights for targeted review.

Quick Start

Set READWISE_API_TOKEN in the environment and run: pnpm tsx scripts/fetch-todays-activity.ts all

Frequently Asked Questions about readwise-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch highlights and activity from Readwise over a custom date range?

This Skill fetches Readwise highlights and activity data using the v2 Highlights API and v3 Reader API for any date range—presets like today, yesterday, last week, last month, or custom start and end dates. Set READWISE_API_TOKEN in your environment and run `pnpm tsx scripts/fetch-todays-activity.ts all` to retrieve structured results.

What output formats does Readwise data export to?

The Skill produces four analysis modes: key learnings, activity timeline, category breakdown, and stats dashboard. Legacy modes also export articles, highlights, and top-highlighted items separately, all formatted as structured results ready for downstream analysis and RAG pipelines.

Can I analyze Readwise highlights by category or time period?

Yes. The Skill generates by-category breakdowns and activity timelines within flexible date ranges. You can use date presets or define custom ranges, and results are organized to support both categorical and temporal analysis of your reading activity.

What prerequisites do I need to connect to Readwise APIs?

You need a READWISE_API_TOKEN set as an environment variable, Node.js with pnpm package manager, and TypeScript tooling via tsx. The Skill handles pagination and enforces 3-second rate-limit delays automatically when querying the Readwise v2 and v3 APIs.

Is there a way to retrieve only top-highlighted content from Readwise?

Yes. The Skill includes a legacy mode that exports top-highlighted items separately from the standard modes. Run the fetch script and select the appropriate output mode to isolate your most-annotated content.

How does this handle rate limits and large Readwise libraries?

The Skill implements automatic 3-second delays between API calls to respect Readwise rate limits and manages pagination internally. Results are transformed into internal types and emitted as batched structured output suitable for large-scale analysis.