# Readwise

Manage your Readwise library by searching, retrieving, and organizing highlights, documents, and videos. Create, update, and delete highlights and documents, add notes, tag content, and track reading…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add IAmAlexander/readwise-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list IAmAlexander/readwise-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get IAmAlexander/readwise-mcp get_highlights

# Call a tool
npx -y @smithery/cli@latest tool call IAmAlexander/readwise-mcp get_highlights '{}'
```

## Direct MCP Connection

Endpoint: `https://readwise-mcp--iamalexander.run.tools`

**Optional config:**
- `debug` (query) — Enable verbose debug logging to troubleshoot issues
- `readwiseApiKey` (query) — Your Readwise API access token. Get it from https://readwise.io/access_token

## Tools (30)

- `get_highlights` — Retrieve highlights from your Readwise library
- `get_books` — Get a list of books from Readwise
- `get_documents` — Retrieve documents from your Readwise library
- `search_highlights` — Search for highlights in your Readwise library
- `get_tags` — Get a list of all tags from Readwise
- `document_tags` — Get, update, add, or remove tags for a document in Readwise
- `bulk_tags` — Add tags to multiple documents in Readwise
- `get_reading_progress` — Get the reading progress of a document from your Readwise library
- `update_reading_progress` — Update the reading progress of a document in your Readwise library
- `get_reading_list` — Get a list of documents with their reading progress from your Readwise library
- `create_highlight` — Create a new highlight in your Readwise library
- `update_highlight` — Update an existing highlight in your Readwise library
- `delete_highlight` — Delete a highlight from your Readwise library
- `create_note` — Create a note on a highlight in your Readwise library
- `advanced_search` — Search highlights with advanced filters and facets
- `search_by_tag` — Search highlights by tags
- `search_by_date` — Search highlights by date range
- `get_videos` — Get videos from Readwise library
- `get_video` — Get video details by document ID
- `create_video_highlight` — Create a highlight on a video at a specific timestamp
- `get_video_highlights` — Get all highlights from a specific video
- `update_video_position` — Update the playback position of a video
- `get_video_position` — Get the current playback position of a video
- `save_document` — Save a new document (URL, article, or webpage) to your Readwise library
- `update_document` — Update metadata for an existing document in your Readwise library
- `delete_document` — Delete a document from your Readwise library (requires confirmation)
- `get_recent_content` — Get the most recently added or updated content from your Readwise library
- `bulk_save_documents` — Save multiple documents (URLs, articles, or webpages) to your Readwise library in bulk (requires confirmation)
- `bulk_update_documents` — Update metadata for multiple documents in your Readwise library in bulk (requires confirmation)
- `bulk_delete_documents` — Delete multiple documents from your Readwise library in bulk (requires confirmation)

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get IAmAlexander/readwise-mcp <tool-name>
```

## Resources

- `readwise://books` — List of books in your Readwise library
- `readwise://highlights/recent` — Recent highlights from your Readwise library
- `readwise://tags` — List of all tags in your Readwise library

## Prompts (2)

- `readwise_highlight` (book_id, page, page_size, search, context, task) — Retrieves and analyzes highlights from Readwise
- `readwise_search` (query, limit, context) — Searches and analyzes highlights from Readwise

---

Source: https://github.com/IAmAlexander/readwise-mcp