Connect Notion

Connect Notion when product plans, decisions, research notes, or work databases live there. Brief can use accessible pages as context and work with pages and databases when you ask it to.

Connect and select content

1. Open Integrations in Brief, find Notion, and select Connect.
2. Authorize Brief in Notion and grant the connection access to the pages or databases you want it to use. If a page is missing later, check its access in Notion.
3. In Brief's Select what to share with your team step, search or browse for pages and databases, select them, then choose Complete Setup. You can select a parent and its descendants or use Select all. Don't share skips this selection.

To revise the team selection, open Configure on the connection and choose Save Changes. Selected pages can provide feature evidence, and selected databases can be considered as work sources. In chat, Notion tools use the requesting user's connected Notion access, so the team selection is not a limit on everything that user can ask the tools to read. Notion's own permissions still apply.

Use pages and databases

Ask Brief to find or read a Notion page, query a database, or summarize a spec. Connected Notion tools can also create or update pages, create databases, edit blocks, and add comments. Give the Notion connection access only to content you intend Brief to work with.

Selected prose pages can provide evidence about product features. When researching decisions, Brief can search and read accessible Notion pages. Separately, when updating strategy context, Brief considers up to 25 recently edited pages accessible to the connection; the team page picker does not restrict that work. It does not fetch every shared page, and edits are not pushed into Brief instantly by Notion webhooks.

Use a Notion database for work

When you select a database during integration setup, Brief reads its properties and checks whether it tracks work. If Brief enables it as a work source, its rows can appear in work and contribute to velocity. A database that does not look like a work tracker may be left out of that use.

For a custom work agent, a workspace admin can choose a specific database in the agent's Sources section. If the database already appears as a source, select it in the list or choose Change selection if shown, then Save when prompted. To connect or finish configuring a database:

1. Open Agents, choose a custom work agent, and find Sources. If no work source is available, choose Connect a Notion database. If a database needs its field mapping completed, choose Configure database or Configure it, whichever appears.
2. Choose a Database. If it is beyond the first 500 listed databases, use its Notion database ID in the mapping form.
3. Choose Propose field mapping, review the suggested properties, and map at least the title. Adjust status and date fields if needed.
4. Choose Confirm mapping. Brief adds the database to the agent's selected sources.

The database must be accessible to the connected Notion account. A database ID by itself does not grant access.

If content is missing

• No pages found: Check the Notion authorization and page access. After granting access in Notion, return to Configure to update the team selection.
• A selected database fails setup: Brief may be unable to read its schema, or the database may lack a readable title property. Check its access and properties, then try again.
• A page edit is not reflected immediately: Ask Brief to read the page again for current content. Background strategy updates are bounded and do not use real-time Notion updates.
• The connection needs authorization again: Use Reconnect in Integrations.

See Connecting your tools, Connect Linear, and Features for related work and product context.