Notion is a fetch-based integration. Modem does not sync or store Notion data. Instead, the agent queries your Notion workspace on demand when you ask. The integration can only access pages and databases that have been explicitly shared with it in Notion.
Prerequisites
- A Notion account with access to the workspace you want to connect
- Admin or Owner role in your Modem organization
The Notion integration is rolling out gradually. If you don’t see it in your integration settings, contact support@modem.dev to get access.
Setup
Start the connection
Go to Settings > Integrations > Notion in your Modem dashboard and click Connect Notion.
Authorize Modem
You’ll be redirected to Notion to authorize the connection. Review the permissions and click Allow access.
Share pages with the integration
The agent can only access pages explicitly shared with the Modem integration. To share a page or database in Notion:
- Open the page in Notion
- Click Share in the top right
- Find and add the Modem integration
What the Agent Can Do
With Notion connected, you can ask the agent to:- Search your workspace for pages and databases by keyword
- Read page content, properties, and comments
- Query databases with filters and sorts
- Create new pages in a database or as a child of another page
- Update page properties (status, priority, assignee, etc.)
- Add comments to pages
- Append content blocks to existing pages
Example Prompts
These work from the dashboard, Slack DMs, or by mentioning@modem in a channel.
Simple:
Advanced:
Sharing and Access
The Notion integration follows Notion’s permission model. The agent can only see and interact with pages that have been explicitly shared with the Modem integration. If the agent can’t find a page you expect, the most common cause is that the page hasn’t been shared with the integration. To share additional pages:- Open the page or database in Notion
- Click Share in the top right
- Search for and add the Modem integration
Troubleshooting
Agent can't find pages or returns empty results
Agent can't find pages or returns empty results
The most common cause is that the page hasn’t been shared with the Modem integration. Open the page in Notion, click Share, and verify the Modem integration has access. Child pages inherit access from their parent, so sharing a top-level page covers everything underneath.
'Could not find page' error
'Could not find page' error
The page exists but wasn’t shared with the integration, or the page ID is incorrect. Use a search query first to find accessible pages, then work with the results.
Property errors when creating or updating pages
Property errors when creating or updating pages
Each Notion database has its own schema with specific property names and types. The agent fetches the database schema before writing, but if property names have changed or don’t match, the operation will fail. Ask the agent to check the database schema first.
Agent says Notion isn't connected
Agent says Notion isn't connected
Verify the integration is connected in Settings > Integrations > Notion. If authorization expired, disconnect and reconnect.
Disconnecting
To disconnect Notion:- Go to Settings > Integrations > Notion
- Click Disconnect, then confirm in the dialog that appears
- Go to Notion Settings & members > Connections
- Find the Modem integration and remove it
Related
The Modem Agent
See what else the agent can do with your connected tools.
Integrations Overview
All available integrations and how they fit together.