Skip to main content
Notion

At a glance

Connect Notion to give Cogno access to your team’s knowledge base — the pages and databases you choose to share. Cogno can read them, query database rows, write new pages and rows, edit pages, and reply to comments. What it may write is set under Agent tools.

Before you start

  • You can open Settings in the target workspace.
  • You’re signed in to the Notion account whose pages you want to share.

Connect Notion in Cogno

1

Open the Notion integration

Open Integrations and find Notion.
2

Authorize Notion

Click Connect. Cogno opens Notion’s authorization screen in a new window. Choose which pages and databases to share, then approve.
3

Confirm the connection

Back in Cogno, the Connection section shows your Notion workspace.

Choose which pages Cogno can see

The Connected pages section lists the pages and databases you’ve shared, each tagged Page, Database, or Data source with its last-edited date, and shows when Cogno last synced them (Last synced — or Not synced yet). Two actions live in the ⋯ menu on the connection row:
  • Sync pages refreshes the list of shared pages and their metadata. It does not refresh saved page bodies.
  • Change pages reopens Notion’s authorization screen so you can adjust what you share.
Cogno reads only the pages and databases you explicitly share. Sharing is managed on Notion’s side during authorization.

What Cogno can do in Notion

Within a Project, Cogno reaches the pages and databases the Project selected and everything under them (sub-pages and database rows, including ones created later). A Project that has not narrowed Notion reaches every page shared with Cogno. Cogno cannot move a page the Project itself selected to the trash.

Agent tools

The Agent tools section on the Notion integration page has two rows, Read Notion and Write to Notion. Each can be set to always allow, ask first, or reject; changes apply from the next run.
Some actions also need the matching capability on Notion’s side — reading and inserting comments, inserting and updating content, and reading user information. If Cogno reports a missing capability, a workspace admin enables it for Cogno’s Notion connection and reconnects with Change pages.

Page body updates

When Cogno works on a page during a run it reads Notion live. Separately, Cogno refreshes individual saved page bodies after Notion content-update notifications or when you add pages to a Project’s page filter. It does not periodically re-read every accessible page’s body. A missed notification or failed refresh can leave a saved body outdated or unavailable; check Notion for the current content. Sync pages updates the page list only.

Disconnect

Open the ⋯ menu on the connection row and choose Disconnect, then confirm.

Common states

Reference URLs