Skip to content

Readwise ​

Connect Readwise to bring the highlights you keep in Readwise into your vault as notes. This works on every plan, free included. It is an integration with your Readwise account, not cloud sync, and it only reads from Readwise: Memry never writes anything back.

Once you have imported, Memry checks Readwise for you: on launch and then every hour by default. See Automatic syncing.

Connect ​

Readwise has no sign-in flow for apps, so Memry uses your personal access token.

  1. Open Settings → Import. Readwise sits first, in its own Reading group. The row says Not connected.
  2. Click the row. In the dialog, choose Get your token to open readwise.io/access_token in your browser, and copy the token.
  3. Paste it into Access token and click Connect.

Memry checks the token with Readwise before it keeps it. A token Readwise does not accept shows an error under the field, and nothing is stored, so you can paste it again.

The token is stored in your system keychain, on this device, for this vault. It never goes into your notes or settings, never syncs to your other devices, and never appears in logs. Connecting is per vault: another vault stays disconnected until you connect it too.

Review and import ​

The first time you open the dialog after connecting, Memry reads your Readwise library and shows what it holds. Nothing is written yet.

  • Each category has a tile with the number of books in it and a switch. Books, Articles, Tweets and Podcasts are on. Supplementals is off, because Readwise adds those books by itself and they hold none of your highlights. A tile reads will import or off. An Other tile appears if Readwise returns a category Memry does not know. Those books are always imported.
  • The intro line gives the totals, such as 2,184 highlights across 545 books are ready, and how many books will import with your switches.
  • List each day's highlights in the journal is a switch below the tiles, off by default. The first import writes nothing to the journal whether it is on or off. See The day's highlights in your journal.
  • Below the tiles, choose the Folder and the Folder layout.

The Import button names what it will do, such as Import 505 books. Press it to start. The dialog shows progress as books are written, and Cancel stops the run after the book in progress. Books already written stay, and you can start the import again. When it finishes, the dialog lists how many books were imported, which were skipped and why, and which failed.

If your Readwise library has no highlights yet, the preview says so, and Import still completes the setup.

What lands in your vault ​

Each book, article, tweet or podcast becomes one note, named after its title. If a note with that name exists, Memry adds its usual number suffix, as in Deep Work 1. The note holds the Readwise section: the cover, then your document note and summary if there are any, then the highlights in the order they appear in the book, each with a link back to Readwise and its date. The author, source, source link (source_url), category, link to Readwise (readwise_url) and book tags are written as properties once, when the note is created. An article's cover image is written as a cover property, and the cover of any other category sits at the top of the section. Images are downloaded into your vault, so the note works offline. Folder names, headings and labels in these notes are in English, whatever language the app uses.

Highlight text is quoted as plain text. A #tag or [[link]] in a highlight does not turn into a Memry tag or link.

Importing again ​

Press Sync now again at any time, or let Memry do it on its schedule. After the first import, Memry asks Readwise only for what changed since the last run, and writes only the books that changed:

  • New highlights arrive in the note. In a section you have not edited, they sit in the order they appear in the book. In a section you edited, they are added at the end, and your edits stay. See What counts as an edit.
  • Edits and deletions in Readwise reach a section you have not edited. In a section you edited, Readwise edits of older highlights do not arrive, and a highlight you deleted from the note stays deleted (see below for the one case it can return).
  • A new book becomes a new note. A note you deleted stays deleted, and Memry does not bring the book back. A book you deleted in Readwise keeps its note, and Memry stops updating it.
  • A note that is open in the editor is skipped and written on the next import after you close it.
  • A book that fails to write, such as one whose folder is read-only, is reported in the summary and fetched again on the next import. It never stops the rest of the run.
  • Turning a category on brings in all of its books on the next import. Turning one off leaves its notes as they are.
  • A change to the whole book with no highlight change, such as a new document note, can take up to a day to reach the note, because Memry reads your whole library once a day to catch those.

If the import stops halfway, for example when you quit the app, the next import covers the same changes again. Nothing is skipped or written twice.

A run that changes nothing writes nothing. A run that changes something adds one line to the vault activity list in Settings, such as Readwise: 3 books, 12 highlights. Your own text above and below the section is never overwritten. Inside the section, Memry re-renders only a section you have not edited. See What counts as an edit.

Readwise Reader ​

Readwise Reader is the read-it-later app. Your Reader highlights already come through the steps above, because Readwise stores them like any other highlight. Memry joins the two: a Reader document that has highlights is one note, and its highlights sit in that note's section. The note lands in the Articles folder, or the folder of its category.

A Reader library can also hold thousands of saved documents you never highlighted. Those stay out of your vault unless you ask. In Readwise Reader, in the dialog's settings, there are two switches, both off:

  • Also import saved Reader documents. Documents in New, Later, Shortlist and Archive that have no highlights become notes in the Reader folder, inside your Readwise folder (with One folder, directly in the Readwise folder). Feed items, such as RSS and newsletters you never saved, are never read. The first-import preview shows a Saved Reader documents tile with a switch. With the switch on, the tile shows how many documents will import, and the Import button counts them as notes. Reading a large library takes a few minutes, because Reader allows 20 requests a minute.
  • Include full article text. The article text is written once, below the Readwise section, when the note is created. After that it is yours: Memry never changes it, and a note that exists when you turn this on does not change. Images inside the text are downloaded into your vault as attachments of the note, so they show offline, and a caption stays under its image. An image that cannot be downloaded is left out with its caption, and Memry does not try it again, because the text is written once. The cover image is saved as usual.

What a Reader note holds, once, when it is created: the author, site name, publication date, word count, source link, link to Reader and the tags. An article's image becomes its cover, and another document's image sits at the top of the section. Where the document is in Reader (New or Archive) and how far you have read are not saved, because they change while you read.

  • One note per document. If you highlight a saved document later, its note stays in Reader and the highlights are added to the section there. Memry never moves a note and never makes a second one.
  • Turning the switch off stops new Reader notes. It deletes none, and it makes no request to Reader.
  • A document you delete in Reader keeps its note. A note you delete stays deleted.
  • Memry only reads from Reader. Nothing is changed in your Readwise account.

The day's highlights in your journal ​

A reading log, if you want one. With List each day's highlights in the journal on, the journal entry of each day you highlighted gets a Readwise section that lists the books and how many highlights you made in each, linked to the book notes:

markdown
<!-- readwise-day:start -->

### Readwise

- [[Deep Work]]: 3 highlights
- [[How to Take Smart Notes]]: 1 highlight

<!-- readwise-day:end v1 hash=4b1e09aa -->

The book notes then show those days as backlinks. The switch is in the dialog's settings, under Journal, and in the first-import preview. It is off by default, because it writes into your journal, which you write yourself. It syncs to your other devices like the other Readwise settings. Nothing is written while the Journal feature is off in Settings → Features.

  • New highlights only. Memry does not fill in the past. The first import, a new device taking over Readwise, and turning a category on write nothing to the journal. Only highlights that arrive in a later sync, while the switch is on, count. A highlight that arrives late goes into the day you made it: a Kindle that syncs on Friday adds to Tuesday's entry, and creates the entry if there is none. That day's section lists every highlight you made that day, older ones included. A book you add to Readwise now can add sections to many past days, because its highlights keep the dates you made them.
  • The day is yours. It is the date of the highlight in this device's time zone.
  • Your edits stay. While you have not changed the section, Memry rewrites it when more highlights arrive. Once you edit it, Memry never rewrites it: it only adds one line, such as - [[Deep Work]]: 2 highlights, for each book that got new highlights. Delete the whole section and the next new highlight of that day adds a fresh one.
  • An open entry waits. If the day's entry is open in the editor, Memry writes it in the first sync after you close it.
  • Links follow titles. The links use each book note's current title, and Memry keeps them valid when you rename a note. A book without a note, such as one in a category you turned off, is not listed.
  • English text. The heading and the counts are in English, whatever language the app uses, so every device writes the same text. The editor draws the section's two comment lines as labeled bands.
  • Turning it off stops new sections. It removes none.

Automatic syncing ​

After your first import, Memry syncs without being asked.

  • On launch. When you open Memry with Readwise connected and Frequency set to Hourly or Daily, it runs one sync a moment after the vault opens.
  • On a schedule. Hourly syncs about once an hour while Memry is open, and Daily once a day. Manual never syncs by itself: nothing runs until you press Sync now. Your choice is saved, so it holds after a restart and on your other devices.
  • Sync now. The button in the Readwise dialog runs a sync right away and shows when it is done. If a sync is already running, it waits for that one instead of starting a second. It cannot join an import you started from the same dialog; wait for that one to finish.
  • Only with a token. Memry never syncs a disconnected vault, and never starts your first import by itself: that one always waits for you, so you see the preview first.
  • Offline. Memry skips a scheduled sync while the computer is offline and tries again on the next minute once it is back. A sync that fails for any reason you do not have to fix (Readwise or the network unavailable, a rate limit, an unexpected error) is retried after 5 minutes, then 10, 20 and so on, up to 6 hours between attempts. Quitting Memry resets the wait, and the next launch syncs right away. A sync that fails halfway writes what it finished, and the next one picks up from there.
  • A token Readwise rejects, or a subscription that expired. Memry stops the schedule instead of trying again every hour, and tells you once. See Sync status. Pasting a fresh token, or Retry now after you renew, resumes the schedule.

Sync status ​

A background sync you cannot see is one you cannot trust. The Readwise dialog starts with a status banner that says what Memry is doing, and the row in Settings → Import shows the same state in a few words. Memry stays quiet while all is well.

The banner saysWhat it meansAction
Synced 5 minutes agoThe last run finished. Below the title: what it changed, such as 1 added, 2 updated, 1 extended, 12 highlights (and, when it applies, how many books wait for an open note or failed), or nothing new, and when the next sync is.
Syncing with ReadwiseA run is going. It shows Reading your library…, then Writing books, 3 of 12.Cancel
Waiting for memry syncThe run waits until sync has pulled your other devices' notes, so no book is written twice. It starts by itself.Cancel
Syncs on Desk MacAnother device pulls from Readwise. See Use Readwise on more than one device.Sync here instead
Readwise needs a new tokenReadwise did not accept the saved token, for example because you made a new one. The schedule is paused.Paste a new token
Your Readwise subscription expiredReadwise refused the account. The schedule is paused. Renew on readwise.io.Retry now
Readwise is limiting requestsToo many requests in a short time. Memry says when it tries again.Retry now
Can't reach ReadwiseYou are offline, or Readwise is down. Memry says when it tries again.Retry now
Readwise had a problemReadwise answered with a server error. Memry says when it tries again.Retry now
The sync stoppedSomething unexpected went wrong during the run. Memry says when it tries again.Retry now

Cancel stops the run after the book in progress. Books already written stay, and the next run continues from where the last finished one stopped. Paste a new token opens a token field under the banner. It replaces the token and keeps your place, so nothing is imported again. Memry cannot tell every expired subscription from a rejected token, and in that case it shows Readwise needs a new token.

The row reads Not connected, Connected, Syncing…, Waiting for sync, Synced 5 minutes ago, Syncs on Desk Mac, Needs a new token, Subscription expired, Rate limited, Can't reach Readwise, Readwise error or Sync failed. When the pulling device has no name yet, the row reads Syncs elsewhere and the banner Syncs on another device.

The one notification ​

Memry shows one notification, and only when you must act: a rejected or revoked token, or an expired subscription. It reads Readwise needs a new token or Your Readwise subscription expired, with an Open Readwise button that opens the dialog. It appears once for each time the problem starts. Failed retries do not show it again, and it returns only after the problem was fixed and then came back. The banner and the row keep showing the problem until you fix it.

A network error or a rate limit shows no notification, because the next run tries again by itself. A successful run shows none either. A run that changed something adds a line to the vault activity list, as described in Importing again.

Fix one book ​

Three cases that importing cannot fix on its own each have a command. They appear on a note that came from Readwise, and they write into the note even while it is open, because you asked for the change.

  • Re-import from Readwise rewrites the Readwise section from scratch. Use it after you edited the section and want Readwise's version back. It asks first, because text you wrote inside the section is lost. Text above and below the section and the note's properties stay. Afterwards the section counts as unedited again, so new highlights, edits and deletions from Readwise reach it as before.
  • Refresh book info writes the author, category, source and source link from Readwise into the note's properties. For an article it also saves the cover image. Readwise tags the note lacks are added. No tag is removed, so a tag you added stays, and a tag Readwise dropped stays too. The note keeps its title and its place in the vault. A field Readwise has no value for is left as it is. This is the only time Memry changes the properties after the note is created.
  • Restore brings back a note you deleted. It lists books and articles that have highlights in Readwise, and saved Reader documents that have none. Open the Readwise dialog and find Deleted books: each row has the title, the day you deleted the note and, for a book, its highlight count. Restore creates the note again with all of its highlights. A saved Reader document comes back with its section, and with the article text and images when Include full article text is on. This is also how to get the text and images back for a note that was created before images were kept. If a note for that book already exists, Memry links to it and does not make a second one.

Find Re-import from Readwise and Refresh book info in the note's more menu (the three dots), under Readwise, and in the command palette, where the second one reads Refresh Readwise Book Info.

These commands need your token, so they run on the device that syncs with Readwise. On another device the two note commands are disabled and say that Readwise syncs on the other device, and Deleted books shows the same line. The list of deleted books lives on the syncing device too, so it starts empty when another device takes over.

What counts as an edit ​

Memry stores a fingerprint of the section it wrote in the closing marker (see Readwise vault formats). At each run it compares the section's text with that fingerprint. Line endings and trailing spaces do not count.

  • Not edited. The text still matches. Memry re-renders the whole section from Readwise, so edits, deletions and new highlights all arrive, and it writes only when the result differs.
  • Edited. Any other change counts: a line you added or removed, a changed word, a removed marker, a second marker. From then on Memry only appends, and it never touches a line you wrote or removed. It adds a highlight when Readwise created it after the newest highlight the section holds (the closing marker records that time, one millisecond past it) and the note holds no link to it yet. Heading highlights (tagged .h1 to .h3) are not appended. A highlight you deleted stays deleted, including the newest one. Sections written by earlier versions record the newest highlight's own time, so there the newest deleted highlight can still come back once.
  • Damaged. If you delete the closing marker, Memry puts a new one after the section and appends from there. If a marker carries a version Memry does not know, it writes nothing to the note. Without a readable closing marker Memry cannot know what it last wrote, so it adds only highlights newer than the newest one the note already links; a deleted highlight newer than all the rest can come back there.
  • Re-import puts a section back to not edited. See Fix one book.

Text above and below the section is never part of this check.

What a vault looks like ​

With the default settings and a few books imported, the vault holds:

Readwise/
  Books/          Deep Work.md
  Articles/       How to Take Smart Notes.md
  Tweets/
  Podcasts/
  Other/          notes of a category Memry does not know
  Supplementals/  only when you switched that category on
  Reader/         only with saved Reader documents on
attachments/<note id>/rw-<16 hex>.png

Each folder appears when its first note is written. With One folder, every note sits directly in Readwise/. The note is a Markdown file:

markdown
---
tags:
  - focus
author: Cal Newport
category: books
source: kindle
readwise_url: 'https://readwise.io/bookreview/101'
---

<!-- readwise:start -->

## Highlights

- Clarity about what matters provides clarity about what does not. ([Page 10](https://readwise.io/open/1001), 2026-10-23)
- To produce at your peak level you need to work for extended periods. ([Page 20](https://readwise.io/open/1002), 2026-10-23)
  - your Readwise note on this highlight

<!-- readwise:end v1 last=2026-10-23T00:15:50.792Z hash=25e1e07d -->
  • Highlights. Each highlight is a list item with a link to it in Readwise, the page, location or time, and the date you made it, in this computer's time zone. A note you wrote in Readwise sits under it as a sub-item. Highlight tags follow the text as #tags. A highlight tagged .h1 to .h3 becomes a heading. Highlights you deleted or discarded in Readwise are not imported.
  • Images. Memry downloads cover and highlight images into attachments/<note id>/ as rw- and 16 characters taken from the image address, up to 25 MB each. An image that fails to download is left out and tried again on the next run.
  • Other sections. A book can also carry Document note and Summary headings above Highlights.

Limits ​

  • Request limits. If Readwise answers that you made too many requests, Memry waits the time Readwise names (up to two minutes) and retries three times before it shows Readwise is limiting requests. Reader allows 20 requests a minute, so a large Reader library takes minutes. Each run lists the four saved locations in Reader when the Reader switch is on.
  • Timeouts. A request that takes longer than 30 seconds fails and is retried on the next run.
  • Waiting for memry sync. After launch, the first run waits for memry sync to finish one pull, up to 2 minutes. If sync has not finished by then, the run is skipped, not failed.
  • One run at a time. A manual sync joins a run that is already going.

What Memry never writes ​

Memry only reads from Readwise: it sends GET requests and nothing else. It never creates, edits or deletes a highlight, a book or a tag in your Readwise account, from a note, a command or a setting. The token is never stored in your vault, your settings, your logs or telemetry.

Memry's anonymous telemetry, when you have it on, records that you connected, disconnected or synced, how long a sync took, counts of books and highlights, and an error code when it failed. It never records a title, a highlight, an address or the token. See Observability & Telemetry.

Choose where notes go ​

Once you have imported, the dialog shows your choices.

SettingDefaultWhat it does
FolderReadwiseThe vault folder new books land in. It is created the first time a note is written.
Folder layoutBy categoryBy category sorts notes into Books, Articles, Tweets and Podcasts folders. One folder puts every note directly in the root folder.
CategoriesSee belowOne switch per category of Readwise item.
Readwise ReaderOffAlso import saved Reader documents and Include full article text. See Readwise Reader.
FrequencyHourlyHow often Memry checks Readwise for new highlights: Manual, Hourly or Daily, under Sync.

Turning a category off keeps the notes you already have and skips its books on the next import. Notes of an unknown category go into an Other folder.

Changing the folder or the layout affects new books only. A note never moves after it is created, and a note you moved yourself stays where you put it. If you rename the root folder in Memry, the Folder setting follows the rename.

These choices sync to your other devices, so a device that takes over keeps them. The token does not: you paste it again on that device.

Use Readwise on more than one device ​

Readwise notes are ordinary notes, so they sync to your other devices like any note. If two devices also pulled from Readwise, they could both write the same new highlight within seconds of each other. A device that opens in the morning could also read Readwise before sync has delivered the notes the other device wrote, and create a second note for every new book. So only one device pulls from Readwise at a time. The others receive the notes through sync.

  • Memry sync on. The device where you connect Readwise becomes the one that pulls. Its name is saved with your synced settings. If another device already pulls, connecting is not offered there. Use Sync here instead (below).
  • Memry sync off. There is no other device to race, so this device pulls and nothing is claimed.
  • Waiting for sync. After Memry starts, the pulling device waits until sync has finished one pull before it reads Readwise. It then sees the notes and edits your other devices made, and it never creates a note that already exists.

Move Readwise to another device ​

On a device that does not pull, the Readwise panel says Syncs on Desk Mac, with the name of the pulling device, and offers Sync here instead.

  1. Click Sync here instead, then paste your access token again. The token never travels between devices, so each device needs its own copy.
  2. Click Sync here instead again. Memry waits until your other devices can see the change, then finishes. Memry sync must be on and caught up for this.
  3. The device that pulled before stops at its next book, deletes its copy of the token, and shows that Readwise now syncs elsewhere. Its notes stay.

The first run on the new device reads your whole Readwise library once. It recognizes the notes that already exist by their readwise_url property, so it does not create them again. A section you have not edited comes out identical, so nothing is written to it. In a section you edited, only the highlights from the time the section last recorded are added.

A deleted note can come back once

Memry remembers that you deleted a book's note on the device that pulled. That memory stays on that device. After you move Readwise, the new device does not know, so it brings that book back once. Delete the note again and it stays deleted.

Readwise on iPhone ​

The iPhone app never talks to Readwise. The notes arrive through sync like any other note, and the app shows what the pulling desktop reports. Nothing on iPhone changes Readwise settings or starts a sync.

Open Settings → Readwise to see:

  • Syncs on, the name of the desktop that pulls from Readwise.
  • Folder, the root folder of the Readwise notes.
  • Last change, when the last run that changed something finished. A run that changed nothing does not move it.
  • Status, Up to date or Needs attention. When a token is rejected or the subscription has expired, a card named Readwise needs attention says which, and that you fix it in memry on that desktop.

The row reads Not connected until a desktop connects Readwise. The pulling desktop writes the status into your synced settings, and only when a run changed something or the error state changed, so an unchanged hourly run sends nothing. An iPhone shows it after its next sync.

In a note, the section markers appear as a thin labeled divider with a book icon, for example Readwise · syncs automatically. The markers are read-only on iPhone, so editing around the section leaves it as it was for the desktop's next run.

Disconnect ​

Click Disconnect in the dialog. Memry deletes the token from this device and forgets where the sync stopped: the cursors, the retry list and the journal's record of highlights it has seen. Every note stays, and there is no option to remove them. Your folder, layout, category, Reader and cadence choices stay, and so does the list of notes you deleted. Connecting again runs a first import with the preview, adopts the notes that exist by their readwise_url, and writes nothing to the journal for highlights it already knew. If this device was the one that pulled, Readwise is free again, and the next device you connect becomes the new one. To connect again, paste a token.

The row in Settings → Import ​

Where other sources show a file type, the Readwise row shows the state of the sync. See Sync status for every state.

Released under the GNU GPL v3.0.