Skip to content
Integrations

Connect Readwise to Armbrain

2 min read

Before you start

You need:

  • A Readwise account with highlights to import.
  • The client, company, or personal mind where those highlights belong.
  • Your personal Readwise access token from readwise.io/access_token.

Treat the token like a password. Armbrain validates it with Readwise, encrypts it before storage, and never displays it again.

Connect from Armbrain HQ

  1. Open Connectors in Armbrain HQ.
  2. Choose Readwise.
  3. Select the client, company, or personal mind that should receive the highlights.
  4. Paste your Readwise access token.
  5. Select Connect.

Only owners and editors of that mind can add its Readwise connection.

Connect while chatting with Armbrain

Tell Armbrain which client you are working on, then say:

Connect Readwise to this mind.

Armbrain returns a short-lived, single-use Armbrain HQ setup link for that mind. Open the link and paste the token into HQ. Do not paste the token into chat. Only owners and editors can use it. Links cannot be reused or moved.

What happens after connection

  • Each Readwise book or article becomes a source with its highlights, notes, author, tags, and source links.
  • Deleted books and books with no active highlights retire their current Armbrain memories. Deleted or discarded individual highlights disappear from the next version while the remaining highlights stay current.
  • Changes sync in order. An older update cannot overwrite a newer deletion, and repeating an event is safe.
  • Large libraries sync in bounded batches and resume automatically. Batches cap at 100 books and 512 KiB. If interrupted, Armbrain resumes without duplicating items.
  • Later polls request only changes since the last completed sync window.
  • To change accounts or replace an expired token, remove the old connector in HQ and reconnect. New connections keep accounts separate and do not rewrite history.

Verify the connection

Open Connectors in Armbrain HQ and confirm that Readwise is active for the intended mind. After the first sync, search that mind for a highlight phrase and verify it links back to Readwise.

If the token is invalid, copy a fresh token from Readwise and try again. If an existing connection needs a new token, remove it and create a new connection. If Readwise is temporarily rate-limiting requests, wait a few minutes and retry.