Xpersona
Claim this agent
agentCLAWHUBUnverified

Readwise

Set up, OAuth-authenticate, and use the Readwise MCP server (mcp2.readwise.io/mcp) via the mcporter CLI. Use when a user asks to connect/auth Readwise MCP, reset or troubleshoot OAuth login (stale redirect ports, invalid state), verify the connection, or run Readwise tools through mcporter. Skill: Readwise Owner: TristanH Summary: Set up, OAuth-authenticate, and use the Readwise MCP server (mcp2.readwise.io/mcp) via the mcporter CLI. Use when a user asks to connect/auth Readwise MCP, reset or troubleshoot OAuth login (stale redirect ports, invalid state), verify the connection, or run Readwise tools through mcporter. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-02T00:24:31.052Z | user Initial re

OpenClaw
View on ClawHub

Rank

62

Safety

84

Downloads

1.2k

Updated

Apr 15, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 4/15/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Apr 15, 2026
Protocol compatibility
OpenClawcompatibility · observed Apr 15, 2026
Adoption signal
1.2K downloadsadoption · observed Apr 15, 2026
Latest release
1.0.0release · observed Feb 2, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install kn7fxxmpkrq7ege5ee8j6vqvmd80ahks:readwise-mcp
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tristanh-readwise-mcp/snapshot"

Documentation

CLAWHUB

14,582 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: readwise-mcp
description: Set up, OAuth-authenticate, and use the Readwise MCP server (mcp2.readwise.io/mcp) via the mcporter CLI. Use when a user asks to connect/auth Readwise MCP, reset or troubleshoot OAuth login (stale redirect ports, invalid state), verify the connection, or run Readwise tools through mcporter.
---

# Readwise MCP (mcporter)

This skill is intentionally kept **short**.
High-level workflows live in: `skills/readwise-mcp/RECIPES.md`.

## Preflight

```bash
command -v mcporter && mcporter --version
```

Ensure you’re in the Clawdbot workspace root where `config/mcporter.json` lives.

## Quick setup (first time)

```bash
# Add the server to the *project* config
mcporter config add readwise https://mcp2.readwise.io/mcp \
  --auth oauth \
  --description "Readwise MCP"

# Start OAuth login (will open a browser)
mcporter auth readwise --reset
```

## Verify it works

```bash
mcporter list readwise --output json
mcporter call readwise.reader_list_tags --args '{}' --output json
```

## Troubleshooting OAuth (common failure modes)

### “Invalid OAuth state”
Cause: you approved in a stale browser tab (old auth attempt / old port).

Fix:
- Close old Readwise OAuth tabs.
- Re-run:

```bash
mcporter auth readwise --reset
```

### Redirecting to an old port even after reset
Cause: browser session reuse.

Fix:
- Use Incognito/Private window.
- Or copy the *new* authorize URL into a fresh profile.

### “Waiting for browser approval…” but you already approved
You must land on:

`http://127.0.0.1:<PORT>/callback?code=...&state=...`

If the redirect hits a different port, mcporter will keep waiting.

To find the expected port:

```bash
cat ~/.mcporter/credentials.json
```

Look for `redirect_uris` and ensure the browser redirect matches exactly.

## Using the server

General pattern:

```bash
mcporter call readwise.<tool_name> --args '{...}' --output json
```

Notes:
- `--args` must be valid JSON (prefer single quotes in shell).
- For Reader locations: `new` = inbox, `later`, `shortlist`, `archive`, `feed` (RSS only).

## Tool index (what’s available)
- `readwise_search_highlights` — search **highlights** (vector + optional field filters)
- `reader_search_documents` — search **Reader documents** (hybrid search)
- `reader_create_document` — save a URL or HTML into Reader
- `reader_list_documents` — list newest documents (and paginate)
- `reader_get_document_details` — fetch a document’s full Markdown content
- `reader_get_document_highlights` — fetch highlights for a document
- `reader_list_tags` — list tag names
- `reader_add_tags_to_document` / `reader_remove_tags_from_document`
- `reader_add_tags_to_highlight` / `reader_remove_tags_from_highlight`
- `reader_set_document_notes` / `reader_set_highlight_notes`
- `reader_move_document` — move between inbox/later/shortlist/archive
- `reader_edit_document_metadata` — edit metadata (including `seen`)
- `reader_export_documents` — export Reader docs as a ZIP

## Quick examples (most-used)

_meta.json

{
  "ownerId": "kn7fxxmpkrq7ege5ee8j6vqvmd80ahks",
  "slug": "readwise-mcp",
  "version": "1.0.0",
  "publishedAt": 1769991871052
}

RECIPES.md

# Readwise MCP — Recipes (opinionated workflows)

These are higher-level workflows built from the Readwise MCP tools.
Use them when you want to *do something useful* (triage, digest, quiz, recommend, organize), not when you’re just testing auth.

---

## 1) Triage inbox (or Later fallback)
Goal: grab the newest 10 docs in **inbox** (location=`new`). If inbox is empty, fall back to **later**. Then present a punchy list: *worth reading now* vs *archive/ignore*.

Commands:

```bash
# 1) Try inbox first
mcporter call readwise.reader_list_documents \
  --args '{
    "limit": 10,
    "location": "new",
    "response_fields":["title","author","url","category","location","created_at","tags","summary","reading_time"]
  }' --output json

# 2) If results is empty (or count==0), fall back to later
mcporter call readwise.reader_list_documents \
  --args '{
    "limit": 10,
    "location": "later",
    "response_fields":["title","author","url","category","location","created_at","tags","summary","reading_time"]
  }' --output json
```

Assistant workflow:
- For each doc: infer topic + expected value.
- Output two buckets:
  - **Read next (why + what to extract)**
  - **Archive/skip (why)**
- Offer actions:
  - Move to `shortlist` or `later`
  - Move to `archive`
  - Add tags (if you have a tagging system)

Optional actions:
```bash
# Move a doc
mcporter call readwise.reader_move_document \
  --args '{"document_id":"<id>","location":"archive"}' \
  --output json

# Add tags
mcporter call readwise.reader_add_tags_to_document \
  --args '{"document_id":"<id>","tag_names":["to-read","topic-ai"]}' \
  --output json
```

---

## 2) Feed digest (last day/week) + “mark as seen” option
Goal: scan what landed recently, summarize the “news”, then let the user either (a) open/read, or (b) mark as **seen** (without archiving).

Notes:
- This is best for RSS/feed items, but can also work for *all* docs updated recently.
- “Mark as seen” uses `reader_edit_document_metadata` with `seen: true`.

Commands:

```bash
# Last 24h (use ISO datetime; pick your timezone and convert if needed)
mcporter call readwise.reader_list_documents \
  --args '{
    "limit": 50,
    "updated_after": "2026-02-01T00:00:00Z",
    "response_fields":["title","author","url","category","location","updated_at","created_at","tags","summary"]
  }' --output json

# Alternative: restrict to RSS/feed items only
mcporter call readwise.reader_list_documents \
  --args '{
    "limit": 50,
    "updated_after": "2026-02-01T00:00:00Z",
    "category": "rss",
    "response_fields":["title","author","url","category","location","updated_at","created_at","tags","summary"]
  }' --output json
```

Assistant workflow:
- Cluster items into 5–10 themes.
- Write a short digest: “what happened” + “why you might care”.
- Offer per-item actions:
  - **Read** (open URL)
  - **Mark seen** (without moving/archiving)

Mark as seen:
```bash
mcporter call readwise.reader_edit_document_metadata \
  --args '{"document_id":"<id>","seen":t

Related agents

Same protocol, similar job.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/TristanH/readwise-mcp",
      "sourceUrl": "https://clawhub.ai/TristanH/readwise-mcp",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-tristanh-readwise-mcp/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tristanh-readwise-mcp/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.2K downloads",
      "href": "https://clawhub.ai/TristanH/readwise-mcp",
      "sourceUrl": "https://clawhub.ai/TristanH/readwise-mcp",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.0",
      "href": "https://clawhub.ai/TristanH/readwise-mcp",
      "sourceUrl": "https://clawhub.ai/TristanH/readwise-mcp",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-02T00:24:31.052Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-tristanh-readwise-mcp/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tristanh-readwise-mcp/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.0",
      "description": "Initial release of Readwise MCP (mcporter) skill. - Provides setup instructions for integrating Readwise MCP via the mcporter CLI, including OAuth authentication. - Documents troubleshooting steps for common OAuth login issues and connection verification. - Lists available Readwise and Reader tools accessible through mcporter, with usage patterns and JSON CLI examples. - Explains shortlist semantics and safety recommendations for workflows that perform write operations. - Points to recipes for common workflows like triaging, feed digests, recommendations, and tagging.",
      "href": "https://clawhub.ai/TristanH/readwise-mcp",
      "sourceUrl": "https://clawhub.ai/TristanH/readwise-mcp",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-02T00:24:31.052Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to Readwise and adjacent AI workflows.