Notion

Connect your Notion workspace to give agents the ability to read, create, and update pages and databases.

Common Agent Capabilities

Search Notion pages and databases
Create new pages with structured content
Update existing pages and database entries
Save decisions and runbooks as durable documentation

Setup Flow

Open studio.scoutos.com/integrations
Click Connect on the Notion integration
Authorize Scout to access your Notion workspace
Select pages and databases Scout can access (grant permissions in Notion)
Select the agent you want to enable Notion for
Enable the Notion tools in the agent’s Tools tab
In your agent instructions, specify which pages/databases the agent can reference

Notion Permissions

When connecting Notion, you’ll be asked to grant Scout access to specific pages and databases. Scout requests:

Read access to view page content and database entries
Write access to create and update pages

Tip: Grant access only to the pages and databases your agent needs. You can adjust permissions later from the Notion integration settings.

Instruction Snippet


For Notion actions:
 
1. Search for existing pages before creating duplicates.
2. Use appropriate database schemas when creating entries.
3. Include links to related Slack threads or external context.
4. Return the Notion page URL after creating or updating.

Prompt Examples

“Create a Notion page for this project brief and link it in Slack.”
“Update the incident runbook database with steps from this thread.”
“Find pages about the Q1 roadmap and summarize the key initiatives.”

Best Practices

Scope Access Appropriately

Only grant Scout access to the workspaces and pages relevant to your agent’s workflow. Use Notion’s sharing settings to control this.

Use Databases for Structured Data

When agents need to create structured records (incidents, decisions, tasks), point them at Notion databases rather than freeform pages.

Maintain Conventions

In your agent instructions, specify naming conventions and templates for new pages to keep your workspace organized.

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