Connect Notion

Sheru browses your Notion pages and databases as a read-only file tree. Connecting takes one internal integration token you create in Notion and paste into Sheru — Sheru stores it locally on your Mac and never sends it anywhere but Notion.

1. Create an internal integration#

1. Open notion.so/my-integrations and click New integration.
2. Give it a name (e.g. Sheru), associate it with your workspace, and keep the type Internal.
3. Under Capabilities, keep only Read content (Sheru is read-only).
4. Save, then copy the Internal Integration Token.

2. Share the pages you want Sheru to see#

Notion integrations only see pages you explicitly share with them. On each page (or a top-level page) you want in Sheru, open the ••• menu ▸ Connections (or Add connections) and add your integration. Anything you don't share stays invisible to Sheru.

3. Paste the token into Sheru#

1. Open Settings (⌘,) ▸ Connectors ▸ Add Connector ▸ Notion.
2. Paste the token into the field and click Connect.

A Notion source appears in the sidebar. The token is stored locally in ~/.sheru/config.json (readable only by you).

What you get#

• Two top-level folders: Pages/ and Databases/.
• Pages/ lists the shared pages; opening one gives a page.md rendered as Markdown, plus a subpages/ folder for nested pages.
• Databases/ lists shared databases; opening one lists its rows, each as a readable .md.

If the root looks empty, you probably haven't shared any pages with the integration yet — add a connection on a page (step 2) and reconnect.

Notes#

• To disconnect, use Remove next to Notion in Settings — that drops the source and forgets the token.
• Revoke the token any time from the integration's page on notion.so/my-integrations.