Notion

Connect your Notion workspace so agents can read pages, create documentation, and update database records without leaving the workflow.

What You Can Do

Capability	Example
Search pages and databases	Find existing runbooks or project briefs before creating duplicates
Create new pages	Auto-generate incident reports, meeting notes, or decision logs
Update database entries	Add rows to a project tracker or update status fields
Read structured content	Pull context from a Notion database to inform agent responses

Setup

The setup takes about 5 minutes. You’ll switch between Scout and Notion once to authorize the connection.

Step 1: Connect Notion to Scout

📍 In Scout

Go to studio.scoutos.com/integrations
Find Notion and click Connect
You’ll be redirected to Notion’s authorization page

📍 In Notion (you’ll be redirected)

Choose the workspace you want to connect
Select which pages and databases Scout can access
Click Allow access

You’ll be redirected back to Scout when complete.

What permissions does Scout request?

Scout requests these permissions from Notion:

Permission	What it’s for
Read content	View page content and database entries
Insert content	Create new pages and add database rows
Update content	Edit existing pages and modify database entries

Scout can only access pages and databases you explicitly share with it during setup. You can adjust which pages are shared any time from the Notion integration settings.

Step 2: Enable Notion Tools on Your Agent

📍 In Scout

Go to your agent’s Settings
Click Add Tool in the Tools section
Search for Notion and enable it
In your agent’s Instructions, tell the agent which databases or pages it should use


You have access to Notion. Use it for the following:
- Incidents database: create a new entry when an incident is resolved
- Runbooks database: search for existing runbooks before drafting new ones
- Always return the Notion page URL after creating or updating content

Testing Your Integration

Once setup is complete, try these in Scout chat:

Ask your agent to search Notion for a specific topic
Ask it to create a test page and confirm you see it in Notion
Ask it to update an existing database entry and verify the change

If Notion tools aren’t showing up, make sure the integration is connected at studio.scoutos.com/integrations and the Notion tool is toggled on in your agent’s Tools tab.

Prompt Examples

“Create a Notion page for this project brief and post the link in Slack.”
“Update the incident runbook database with steps from this thread.”
“Find pages about the Q1 roadmap and summarize the key initiatives.”
“Check if we already have a runbook for this error type, and create one if not.”

Best Practices

Scope Access Appropriately

Only share the Notion pages and databases your agent actually needs. Notion’s sharing model lets you be precise — share a single database rather than an entire workspace section. You can add or remove access any time from Notion’s sharing settings.

Use Databases for Structured Data

For recurring content like incidents, decisions, or tasks, point your agent at a Notion database rather than freeform pages. Databases give you consistent schemas and make it easier to search and filter entries later.

Set Naming Conventions in Instructions

If your agent creates pages frequently, add a naming convention to your instructions. For example: Name new pages as "[Date] - [Topic]" and place them in the Incidents database. This keeps your workspace organized without manual cleanup.

Troubleshooting

Agent says it can’t find a page or database

Notion’s permissions are opt-in. If Scout can’t see a page:

Open the page or database in Notion
Click Share in the top right
Find the Scout integration and make sure it has access
Alternatively, go to studio.scoutos.com/integrations , disconnect Notion, and reconnect to re-select pages

Scout can only access content explicitly shared with it — it won’t have access to your full workspace by default.

I connected Notion but my agent doesn’t see Notion tools

Go to your agent’s Tools tab in Scout
Make sure the Notion tool is toggled on
Confirm Notion shows as Connected in your integrations list

If it still doesn’t work, try disconnecting and reconnecting the integration.

Agent is creating duplicate pages

Add a search step to your agent instructions:


Before creating a new Notion page, search for existing pages on the same topic.
Only create a new page if nothing relevant exists.

This prompts the agent to check first rather than creating blindly.

Notion authorization failed or timed out

If the OAuth flow didn’t complete:

Go to studio.scoutos.com/integrations
If Notion shows as connected, disconnect it first
Click Connect and complete the Notion authorization again
Make sure you’re logged into the correct Notion workspace before authorizing

Pop-up blockers can sometimes interrupt the OAuth redirect. If the Notion window closes unexpectedly, disable your pop-up blocker and try again.

Next Steps

Slack: Post updates to channels
Collections: Sync Notion content for search
Integrations Overview: Build your full integration stack

Built with ❤️ by Scout OS