Plannotator can save plans to Notion as child pages of a page you choose. The integration uses your local Notion integration token; Plannotator never stores the token in browser settings.
Setup
-
Create an internal integration or personal access token in the Notion developer portal.
-
Copy its token into the environment that starts Plannotator:
export NOTION_TOKEN="ntn_..." -
In Notion, open the page under which plans should be created and share it with your integration.
-
Open Settings > Notion in Plannotator, enable Notion, and paste the parent page URL or ID.
The token persists through future sessions wherever you keep your environment secrets. It is read only by the local Plannotator server and is never sent from the browser.
The Notion option appears only when NOTION_TOKEN is set. It is off in remote sessions (PLANNOTATOR_REMOTE, SSH) and --tailscale sessions, because anyone who can open the page would save with your token.
Exporting
Use Export > Notes, Save to Notion in the header menu, or set Notion as the default Cmd/Ctrl+S destination. You can also enable Auto-save on Plan Arrival.
Each export creates a new child page. The plan’s first H1 becomes the page title, and the rest of the plan becomes the page body (Notion Markdown).
Troubleshooting
Set NOTION_TOKEN: start Plannotator withNOTION_TOKENdefined.token is invalid or revoked: create or restore a valid Notion token.Share the parent page: add your Notion integration to the parent page’s connections before exporting.- Markdown extensions unique to Plannotator may not render exactly as they do in Plannotator.
