Set up

  1. Create an internal integration in Notion and share each database with it.
  2. Set NOTION_TOKEN in the environment.
  3. Map each database in schema/connectors/notion.yaml.

The mapping file

Each entry maps one Notion database to one node type.

How conflicts are settled

Rows and nodes are matched by notion_id, then by title.
  • If only one side changed a mapped field since the last sync, that side wins.
  • If both changed it, the brain keeps its value and the Notion value goes to Review for the owner to decide.
  • A Notion option with no mapped brain value is left alone.
Sync state is kept in .brain/sync/notion.json.

Testing safely

Never run the sync in a test copy of the vault: it writes to the real Notion workspace. See Testing.