> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squasher.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Connect selected Notion pages and data sources for read-only agent context.

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

<Steps>
  <Step title="Open your project integrations">
    In Squasher, open **Integrations**, choose **Notion**, and click **Connect Notion**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Test read access">
    Search for a selected page from Squasher. A page that was not selected stays unavailable.
  </Step>
</Steps>

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

```text theme={null}
Connect Notion to Squasher project <project_id>. Give me the authorization link. After I select the pages, search the shared runbooks and read only the page needed for this incident.
```

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.