Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

Notion

Connect Notion so the Modem Agent can access your workspace

The Notion integration connects your Notion workspace to the Modem Agent. Once connected, the agent can search your pages and databases, read content, create new pages, update properties, and add comments from chat.

Prerequisites

  • A Notion account with access to the workspace you want to connect
  • Admin or Owner role in your Modem organization

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:

  1. Open the page in Notion
  2. Click Share in the top right
  3. Find and add the Modem integration

Any child pages under a shared parent are also accessible.

Set a default page (optional)

In your Notion integration settings, choose a default page. The agent uses this as the default parent when creating new Notion pages, unless you specify otherwise. You can search for any page the integration has access to.

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

In the web dashboard and in Slack, read operations happen automatically, and write operations (creating pages, updating properties, adding comments) require your approval before the agent executes them. Automations, Discord and Microsoft Teams conversations, and agent runs started through the Modem MCP Server have no approval step, so the agent makes writes there without asking. In a web chat, the lock button in the message box turns approvals off for that conversation.

Example Prompts

These work from the dashboard, Slack DMs, or by mentioning @modem in a channel.

Simple:

PromptFind our product roadmap on Notion
PromptWhat tasks are in progress in the engineering database?
PromptShow me the most recent meeting notes

Advanced:

PromptLook at the top bug report topics from the last week and add them to our Notion issues database
PromptSummarize all open tasks assigned to Alice in our Notion project tracker
PromptCreate a new page in our feedback database with a summary of the billing complaints from Slack this week
PromptCross-reference our Notion roadmap with the most requested features in Modem topics

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:

  1. Open the page or database in Notion
  2. Click Share in the top right
  3. Search for and add the Modem integration

Troubleshooting

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

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

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

Verify the integration is connected in Settings > Integrations > Notion. If authorization expired, disconnect and reconnect.

Disconnecting

To disconnect Notion:

  1. Go to Settings > Integrations > Notion
  2. Click Disconnect, then confirm in the dialog that appears

To revoke access from Notion’s side:

  1. Go to Notion Settings & members > Connections
  2. Find the Modem integration and remove it

Was this page helpful?