Skip to main content
The Notion connection gives Squasher agents read-only access to the pages that you select in Notion. Squasher cannot read pages that you do not share through the Notion page picker.

​
Connect Notion

1

Open your project integrations

In Squasher, open Integrations, choose Notion, and click Connect Notion.
2

Select pages in Notion

Complete Notion’s consent flow. Use the Notion page picker to select the runbooks, service guides, or data sources that the project can use.
3

Test read access

Search for a selected page from Squasher. A page that was not selected stays unavailable.
The connection uses Notion’s read-content capability. It does not update pages or request user information. Disconnecting the integration revokes the Notion grant and removes its stored tokens. The Squasher Notion integration must be registered as a public OAuth integration before customers outside its owner workspace can connect. Notion can require a refreshed consent if permissions change. Squasher stores the rotating access and refresh tokens on the server.

​
Agent operations

Agents can use the connection to:
  • Search selected pages and data sources by title.
  • Read page metadata and bounded nested block content.
  • Inspect a current Notion data-source schema.
  • Page through entries in a selected data source.
These are declared, read-only agent operations. The connection does not give the agent a general Notion API client and does not let it write arbitrary pages. Large or deeply nested pages return a bounded response. Use a narrower page or data source when a response reports that it was truncated.

​
Agent handoff

MCP clients can search for providerCapabilities.notion operations and execute the read operation that matches the task. The connect operation returns a URL for the required human consent step.