Connectors · Notion

Connecting Notion, page by page.

What Notion lets you see or not is on the Notion product page. Here is how to create the integration, share the right pages, and remove it.

Before you start

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.

Authorize

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:

shell

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.

What gets synced

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.

Check the status

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

shell

kastel connector notion sync

Remove it

You want to	The gesture
Remove the token, keep what was ingested	"Disconnect" (console), or `kastel connector notion offboard <workspace>`
Actually delete what was ingested	`kastel erase --connector notion` or the `/erasures` review

A question about your Notion?

Write to us: a question sent by email gets an answer the same day. Our partner integrator network can also help.