Skip to main content
The Notion connection lets agents that use Squasher read your runbooks and service guides. The agent can read only the pages and data sources that you select in Notion, and it cannot change them.
To connect in the dashboard, open Integrations and select Connect on the Notion card. The API steps below do the same. If the card shows Unavailable, the Notion connection is not available yet, and the API returns 503.

​
What you need

  • A Notion workspace, and permission to share its pages with an integration.
  • An API key for the project with write access (the project:write or write scope), in SQUASHER_API_KEY.

​
Connect Notion

1

Get an authorization link

The response has a url. It works for 10 minutes.
2

Select pages in Notion

Open the url, sign in to Notion, and select the pages and data sources that agents may read. Notion then sends you back to the Squasher Integrations page.
3

Test the connection

Search for a page that you selected:

​
What agents can read

Each operation is read-only. In the Squasher MCP server, search for notion to find them.

​
Limits

  • The search matches titles only, up to 200 characters of query text.
  • Page content stops at 500 blocks or 8 levels of nesting. The response then says truncated. Read a smaller page instead.
  • Agents cannot write to Notion, and cannot read pages that you did not select. To add pages, share them with the integration in Notion.
  • Squasher’s own AI triage does not read Notion.
  • To disconnect, send DELETE to /v1/projects/<project-id>/providers/notion/connection. Squasher revokes the access in Notion and deletes its tokens.

​
Next steps

MCP server

Connect an agent to Squasher.

Provider capabilities API

All Notion endpoints and their fields.