Connecting Notion, page by page.

Why connect Notion · How a connector works

Create an internal integration in your Notion workspace settings (Settings > Connections > manage integrations), and give it a recognizable name.

Then share, with that integration, the pages or databases you want readable - the same share menu you would use to invite a colleague. Nothing else is even listed.

Managed: paste the integration token into the Notion card in your Sources; Kastel verifies it live against Notion before accepting it, and never shows it again afterward. Self-host:

kastel connector notion connect <workspace> --token-env NOTION_TOKEN

Prefer an environment variable over a plaintext token on the command line. This gesture happens once per workspace: it does not need to be repeated person by person.

Pages shared with the integration, database rows included; only block text comes in, never images or attached files. Notion publishes no change feed: every pass re-enumerates shared pages, but an unchanged page costs nothing to re-read.

90-day default window at first sync, like other sources (self-host: connectors.notion.history_days). A page that leaves the share, is archived, or deleted at the source is reconciled on the next pass.

Managed: the Notion card in your Sources shows the connected workspace. Self-host:

kastel connector notion sync