Readwise

Educationby Readwise Inc.

Launched Mar 25, 2026 on ChatGPT

The official app for Readwise and Reader.

This app allows you to have chatgpt semantically search through all of your highlights, and any content saved to your Reader library.

More than that, it can do basically anything you can do in Reader! Triage your inbox, organize your library, catch up on your feed, and much more -- just ask :)

22ChatGPT Tools

Readwise Inc.Developer

EducationCategory

Available Tools

Reader Add Tags To Document

reader_add_tags_to_document

Full Description

Add tags to a Reader document

Parameters (2 required)

Required

document_idstring

The ID of the document to add tags to

tag_namesarray

The tag names to add to the document

Reader Add Tags To Highlight

reader_add_tags_to_highlight

Full Description

Add tags to a Reader document highlight

Parameters (3 required)

Required

document_idstring

The ID of the document containing the highlight

highlight_document_idstring

The ID of the highlight document to add tags to

tag_namesarray

The tag names to add to the document

Reader Bulk Edit Document Metadata

reader_bulk_edit_document_metadata

Full Description

Edit metadata fields for one or more Reader documents in a single call. Max 50 documents per call. Bulk update calls are rate-limited to 20 per minute (shared with reader_move_documents) — batch documents into fewer calls instead of calling once per document. Check the result success flags to confirm all documents have been edited successfully.

Parameters (1 required)

Required

documentsarray

List of documents to edit, each with a document_id and the metadata fields to update

Reader Create Document

reader_create_document

Full Description

Save a new document to Reader

Parameters (0 required, 11 optional)

Optional

authorstring

The document's author, overwrites the original author

Default: null

categorystring

The document category. Default is guessed based on the URL, usually article.

Default: null

htmlstring

The content of the document in HTML format. Use `markdown` instead if you have Markdown content. If not provided, Reader will try to scrape the URL.

Default: null

image_urlstring

An image URL to use as cover image

Default: null

markdownstring

The content of the document in Markdown format. Use `html` instead if you have HTML content.

Default: null

notesstring

A top-level note for the document

Default: null

published_datestring

When the document was published in ISO 8601 format

Default: null

summarystring

Summary of the document

Default: null

tagsarray

A list of tags to apply to the document

Default: null

titlestring

The document's title, overwrites the original title. Should be provided when `html` is provided.

Default: null

urlstring

The unique URL of the document. If you don't have one, you can provide a made up value such as https://yourapp.com#document1

Default: null

Reader Create Highlight

reader_create_highlight

Full Description

Create a new highlight on a document by specifying the exact text to highlight

Parameters (2 required, 2 optional)

Required

document_idstring

The ID of the document to highlight

html_contentstring

The exact HTML fragment to highlight. Must match a part of the HTML document exactly. The full HTML can be obtained from the reader_list_documents tool (html_content).

Optional

notestring

Optional note to attach to the highlight

Default: null

tagsarray

Optional tag names to apply to the highlight

Default: null

Reader Export Documents

reader_export_documents

Full Description

Export all Reader documents as a ZIP file containing Markdown files with YAML frontmatter. This tool triggers the export and returns immediately with an export_id. Use reader_get_export_documents_status to poll for completion and get the download URL. The response includes last_updated which can be saved and passed as since_updated in a future export to only include documents updated since this export.

Parameters (0 required, 1 optional)

Optional

since_updatedstring

Optional timestamp for delta exports. Only documents updated after this timestamp will be included. Use `last_updated` from a previous export.

Default: null

Reader Get Document Details

reader_get_document_details

Full Description

Get Reader document details, including Markdown content

Parameters (1 required)

Required

document_idstring

The ID of the document to get details for

Reader Get Document Highlights

reader_get_document_highlights

Full Description

Get highlights for a Reader document

Parameters (1 required)

Required

document_idstring

The ID of the document to get highlights for

Reader Get Export Documents Status

reader_get_export_documents_status

Full Description

Check the status of a previously triggered Reader document export. Returns status ('processing' or 'completed'), progress counts, and a download_url when the export is complete.

Parameters (1 required)

Required

export_idstring

The export ID returned by `reader_export_documents`.

Reader List Documents

reader_list_documents

Full Description

List Reader documents. Documents are returned from the most recently added to the least recently added. This tool can be used to find N newest documents. Tip: unseen documents have first_opened_at=null, seen documents have a non-null first_opened_at. You can mark documents as seen with reader_bulk_edit_document_metadata(documents=[{document_id: ..., seen: true}]).

Parameters (0 required, 9 optional)

Optional

categorystring

Filter by document category

Default: null

idstring

The document's unique ID. Using this parameter will return just one document, if found.

Default: null

limitinteger

The maximum number of documents to return

Default: 10

locationstring

Filter by document location. 'new' = inbox (where newly saved documents go), 'later' = saved for later, 'shortlist' = shortlisted, 'archive' = archived, 'feed' = RSS feed items (only use when user explicitly asks about feed/RSS). When user says 'inbox', use 'new'.

Default: null

page_cursorstring

A string returned by a previous request to get the next page of documents

Default: null

response_fieldsarray

Optional fields to include in each document result. Use this to reduce response size and save tokens. The 'id' field is always included. If not specified, all fields are included.

Default: null

seenboolean

Filter by seen status. True = only documents that have been opened, False = only unopened documents.

Default: null

tagarray

Filter by tag(s). Pass up to 5 tags to find documents having all the tags listed. Pass empty string in the list to find untagged documents.

Default: null

updated_afterstring

Fetch only documents updated after this date (ISO 8601 datetime)

Default: null

Reader List Tags

reader_list_tags

Full Description

List Reader tags

Reader Move Documents

reader_move_documents

Full Description

Move one or more Reader documents to a different location (e.g. archive, later, shortlist). Max 50 documents per call. Bulk update calls are rate-limited to 20 per minute (shared with reader_bulk_edit_document_metadata) — batch document IDs into fewer calls instead of calling once per document. Check the result success flags to confirm all documents have been moved successfully.

Parameters (2 required)

Required

document_idsarray

The IDs of the documents to move

locationstring

The new location for the documents

Options:newlatershortlistarchivefeed

Reader Remove Tags From Document

reader_remove_tags_from_document

Full Description

Remove tags from a Reader document

Parameters (2 required)

Required

document_idstring

The ID of the document to remove tags from

tag_namesarray

The tag names to remove from the document

Reader Remove Tags From Highlight

reader_remove_tags_from_highlight

Full Description

Remove tags from a Reader document highlight

Parameters (3 required)

Required

document_idstring

The ID of the document containing the highlight

highlight_document_idstring

The ID of the highlight document to remove tags from

tag_namesarray

The tag names to remove from the document

Reader Search Documents

reader_search_documents

Full Description

Search Reader documents using hybrid search

Parameters (1 required, 17 optional)

Required

querystring

Search in document content

Optional

author_searchstring

Search document author

Default: null

category_inarray

Restrict search to specific categories

Default: null

document_idstring

Restrict search to a specific document

Default: null

limitinteger

The maximum number of documents to return

Default: 20

location_inarray

Restrict search to specific locations. Values: 'new' (inbox), 'later', 'shortlist', 'archive'. When user says 'inbox', use ['new']. This tool does not search the feed, only locations in the user's library.Defaults to ["new", "later", "shortlist", "archive"].

Default: null

note_searchstring

Search in document notes

Default: null

published_datestring

Search by published date (ISO 8601 date)

Default: null

published_date_gtstring

Search by published date greater than (ISO 8601 date)

Default: null

published_date_gtestring

Search by published date greater than or equal to (ISO 8601 date)

Default: null

published_date_ltstring

Search by published date less than (ISO 8601 date)

Default: null

published_date_ltestring

Search by published date less than or equal to (ISO 8601 date)

Default: null

source_searchstring

Search in document source

Default: null

summary_searchstring

Search in document summary

Default: null

tags_inarray

Restrict search to specific tags

Default: null

tags_searchstring

Search in document tags

Default: null

title_searchstring

Search in document title

Default: null

url_searchstring

Search in document URL

Default: null

Reader Set Highlight Notes

reader_set_highlight_notes

Full Description

Set notes for a Reader document highlight

Parameters (2 required, 1 optional)

Required

document_idstring

The ID of the document containing the highlight

highlight_document_idstring

The ID of the highlight document to set notes for

Optional

notesstring

The notes to set for the highlight. Pass null to clear the notes.

Default: null

Readwise Create Highlights

readwise_create_highlights

Full Description

Create one or more highlights in Readwise. When creating a Reader document highlight, use reader_create_highlight instead. Each highlight can be from the same or multiple books/articles. If you don't include a title, we'll put the highlight in a generic 'Quotes' book. If you don't include an author we'll keep it blank or just use the URL domain (if a source_url was provided). We de-dupe highlights by title/author/text/source_url. We'll put the created highlights in a book, based on the title/author/source_url combination.

Parameters (1 required)

Required

highlightsarray

List of highlights to create

Readwise Delete Highlight

readwise_delete_highlight

Full Description

Delete a Readwise highlight

Parameters (1 required)

Required

highlight_idinteger

The ID of the highlight to delete

Readwise Get Daily Review

readwise_get_daily_review

Full Description

Get the user's daily review of highlights. Returns today's review with all highlights selected for review by the spaced repetition algorithm. Includes the review URL where the user can complete the review interactively.

Readwise List Highlights

readwise_list_highlights

Full Description

List Readwise highlights with optional filters. Highlights are returned from the most recently added to the least recently added. This tool can be used to find N newest highlights.

Parameters (0 required, 7 optional)

Optional

book_idinteger

Filter by book ID

Default: null

highlighted_at_gtstring

Filter highlights created after this datetime (ISO 8601)

Default: null

highlighted_at_ltstring

Filter highlights created before this datetime (ISO 8601)

Default: null

pageinteger

Page number for pagination

Default: null

page_sizeinteger

Number of highlights per page

Default: 100

updated_gtstring

Filter highlights updated after this datetime (ISO 8601)

Default: null

updated_ltstring

Filter highlights updated before this datetime (ISO 8601)

Default: null

Readwise Search Highlights

readwise_search_highlights

Full Description

Search Readwise highlights

Parameters (1 required, 2 optional)

Required

vector_search_termstring

Searches document content using vector search

Optional

full_text_queriesarray

Optional field targeted full text search queries

Default: null

limitinteger

The maximum number of highlights to return

Default: 30

Readwise Update Highlight

readwise_update_highlight

Full Description

Update a Readwise highlight. Supports adding and removing tags in a single call.

Parameters (1 required, 7 optional)

Required

highlight_idinteger

The ID of the highlight to update

Optional

add_tagsarray

Tag names to add to the highlight

Default: null

colorstring

New color for the highlight

Default: null

locationinteger

New location for the highlight

Default: null

notestring

New note for the highlight

Default: null

remove_tagsarray

Tag names to remove from the highlight (matched by name)

Default: null

textstring

New text for the highlight

Default: null

urlstring

New URL for the highlight

Default: null

Links

Website Privacy Policy Terms of Service