Connect your Readwise and Reader library to AI agents using the Model Context Protocol for semantic search and document management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install readwise-mcp
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install readwise-mcp using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Readwise MCP (mcporter)?
The Readwise MCP skill allows you to bridge your Readwise highlight library and Reader document database with AI agents using the mcporter CLI. By leveraging the Model Context Protocol, this skill enables programmatic access to your personal knowledge base, making it easier to integrate your reading habits into automated workflows. It is a cornerstone for users looking to enhance their personal knowledge management through Openclaw Skills.
This integration supports full OAuth authentication and provides a suite of tools for searching, organizing, and retrieving content. Whether you are performing vector searches on highlights or fetching the full Markdown content of a saved article, this skill provides a robust interface for interacting with your Readwise data.
Readwise MCP (mcporter) Use Cases
- Performing semantic vector searches across your entire highlight history for research.
- Triaging a cluttered Reader inbox by moving documents to archive or later.
- Fetching the full Markdown text of articles to provide context for AI-driven summaries.
- Automating document tagging based on content analysis.
- Building custom reading digests or 'next-to-read' recommendation engines.
How Readwise MCP (mcporter) Works
- The mcporter CLI is used to register the Readwise MCP server within the local project configuration.
- An OAuth handshake is initiated to securely authorize access to your Readwise account.
- The skill exposes a series of standardized tools (e.g., reader_list_documents) to the AI agent.
- Commands are executed via the mcporter call interface, passing JSON arguments to the MCP server.
- Results are returned in structured JSON format, allowing the agent to parse highlights or document metadata.
Readwise MCP (mcporter) Setup
First, ensure mcporter is installed and accessible in your environment. You can then add the server and authenticate:
# Add the server to the project configuration
mcporter config add readwise https://mcp2.readwise.io/mcp \
--auth oauth \
--description "Readwise MCP"
# Start the OAuth login process
mcporter auth readwise --reset
# Verify the connection
mcporter list readwise --output json
Readwise MCP (mcporter) Data Schema & Taxonomy
The skill manages data across local configuration files and remote API responses, structured as follows:
| Data Type | Description | Key Fields |
|---|---|---|
| Credentials | Stored in ~/.mcporter/credentials.json |
OAuth tokens, redirect URIs |
| Highlights | Semantic search results | vector_search_term, text, tags |
| Documents | Reader library entries | title, author, url, location, category |
| Content | Full-text article data | document_id, markdown_content |
Readwise MCP (mcporter) Advanced Features
- Vector-first semantic search for deep retrieval of highlights.
- Hybrid search capabilities for Reader documents to balance keywords and context.
- Custom location semantics supporting inbox, later, shortlist, and archive workflows.
- Export capabilities allowing Reader documents to be saved as ZIP files.
- Safety-first write operations that generate a read-only plan for user approval before modifying data.
- Integration-ready for more complex Openclaw Skills recipes like feed digests and automated triaging.
SKILL.md
Loading
Related Openclaw Skills
Nexus Nova
A sophisticated personality architecture that transforms AI agents from simple scripts into autonomous entities with genuine identity and emotional depth.
Strands Agents SDK
A Python SDK for building autonomous AI agents and multi-agent orchestrations with native support for AWS Bedrock, local LLMs, and MCP tools.
rbw (Bitwarden CLI)
A high-performance CLI client for Bitwarden and Vaultwarden designed for secure credential retrieval and script integration.
Obsidian
A powerful automation skill for managing Obsidian vaults and Markdown notes via the command line using notesmd-cli.
AI Codebase Deep Modules
A specialized skill for refactoring software architectures into deep, AI-navigable modules with enforced boundaries and fast feedback loops.
App Store Readiness Audit
An automated compliance auditor for iOS repositories ensuring App Store and TestFlight readiness.
Featured*
