Readwise Reader

v0.2.3

Interact with Readwise Reader library to list, create, update, and delete documents. Use when the user wants to manage their saved articles, reading lists, o...

⭐ 1· 134·0 current·0 all-time

byYingxin Wu@xinthink

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for xinthink/readwise-reader.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "Readwise Reader" (xinthink/readwise-reader) from ClawHub.
Skill page: https://clawhub.ai/xinthink/readwise-reader
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required env vars: READWISE_ACCESS_TOKEN
Required binaries: pip, python
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install readwise-reader

ClawHub CLI

Package manager switcher

npx clawhub@latest install readwise-reader

Security Scan

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

✓

Purpose & Capability

Name/description (Readwise Reader) align with required binaries (python, pip), the single required env var (READWISE_ACCESS_TOKEN), and the scripts which call Readwise's API (BASE_URL = https://readwise.io). All requested resources are appropriate for the stated functionality.

✓

Instruction Scope

SKILL.md and the scripts only reference Readwise API endpoints, local payload files, and optional .env usage. The instructions do not attempt to read unrelated system files, other environment variables, or transmit data to unexpected endpoints. Scripts read user-provided payloads and may write output files as documented (expected behavior).

ℹ

Install Mechanism

There is no formal install spec (instruction-only in registry) but the package includes runnable Python scripts and a requirements.txt (httpx, python-dotenv). Users must run pip install -r scripts/requirements.txt manually; this is low-risk but the absence of an automated install step means callers should inspect/verify dependencies before running.

✓

Credentials

The single required env var is READWISE_ACCESS_TOKEN (declared as primaryEnv) and is used exclusively for authentication to the Readwise API. No unrelated secrets or config paths are requested.

✓

Persistence & Privilege

The skill is not always-enabled, does not request elevated system persistence, and does not modify other skills or system-wide agent settings. Autonomous invocation (default) is allowed but not combined with other concerning privileges.

Assessment

This skill is coherent with its purpose, but before installing: (1) verify the READWISE_ACCESS_TOKEN you provide is limited to the Readwise account you intend to use, (2) inspect the included scripts yourself (they are plain Python) and only run pip install for the listed dependencies in a controlled environment (virtualenv/container), and (3) be aware that listing/printing operations will output your library data (which could be written to files if you use --output).

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

📚 Clawdis

Binspip, python

EnvREADWISE_ACCESS_TOKEN

Primary envREADWISE_ACCESS_TOKEN

latestvk97cebff6c51jrjcev0qqp3w3h83myzrv0.2.3vk97cebff6c51jrjcev0qqp3w3h83myzr

134downloads

1stars

3versions

Updated 1mo ago

v0.2.3

MIT-0

Reader

Interact with Readwise Reader library using executable scripts.

Quick Start

All Reader operations are available as scripts in the scripts/ subdirectory:

Script	Purpose	Input
`list_documents.py`	Query documents	CLI flags
`create_document.py`	Save URL/content	JSON payload
`update_document.py`	Modify document	JSON payload
`bulk_update_documents.py`	Batch modify (max 50)	JSON payload
`delete_document.py`	Remove documents	JSON payload
`list_tags.py`	List all tags	CLI flags

Authentication

Set the READWISE_ACCESS_TOKEN environment variable using one of these methods:

Method 1: Using a `.env` file

Create a .env file in the project directory:

READWISE_ACCESS_TOKEN=your-token-here

The scripts automatically load environment variables from .env using python-dotenv.

Method 2: Command line

Export in shell:

export READWISE_ACCESS_TOKEN=your-token-here

Or inline for a single command:

READWISE_ACCESS_TOKEN=your-token-here python scripts/list_documents.py

Getting your token

Get your token from: https://readwise.io/access_token

Setup

Install the required dependencies before using the scripts:

pip install -r scripts/requirements.txt

Common Workflows

List documents in a folder

python scripts/list_documents.py --location later --limit 10

Save a URL with tags

echo '{"url": "https://example.com/article", "tags": ["important"]}' | python scripts/create_document.py

Archive a document

echo '{"id": "doc-id", "location": "archive"}' | python scripts/update_document.py

Bulk archive multiple documents

echo '{"updates": [{"id": "doc1", "location": "archive"}, {"id": "doc2", "location": "archive"}]}' | python scripts/bulk_update_documents.py

Error Handling

Exit Code	Meaning	Action
0	Success	Parse stdout
1	API error	Check stderr for details
2	Auth error	Verify `READWISE_ACCESS_TOKEN`
3	Rate limit	Wait and retry
4	Invalid input	Fix payload/flags

Errors are written to stderr in JSON format:

{"error": {"type": "...", "message": "...", "hint": "..."}}

Rate Limits

Scripts automatically handle retries for rate limits (429) and server errors (5xx). No action needed unless exit code 3.

Resources

Usage Guide: references/usage-guide.md

Comments

Loading comments...