Skip to main content
The Notion integration lets each user link their own Notion account so agents can search the workspace, read pages and databases as markdown, query data sources, and, with approval, create and update Notion content. A tenant admin registers the Notion integration once; each user then authorizes with their own Notion account and chooses which pages and databases the integration may access in Notion’s consent picker. The tool surface mirrors Notion’s official MCP server.
Aperium calls Notion as the connecting user and only ever sees the pages and databases that user grants during Notion’s consent step.

​
What you’ll need

  • A Notion public integration (OAuth) registered in your Notion workspace, and its client ID and client secret.
  • Access to the Aperium admin onboarding flow or the Admin Console’s MCP Servers tab.

​
Admin setup

1

Register a Notion public integration

In Notion’s integration settings, create a public (OAuth) integration. Aperium’s setup form displays the exact redirect (callback) URL to register — copy it from the form into Notion’s integration configuration.
2

Paste the credentials into Aperium

Open the Connect Aperium to Notion form and enter the client ID and client secret. Once saved, the Notion tile appears on every user’s Integrations page.
3

Users link their accounts

Each user clicks connect on the Notion tile, is redirected to Notion’s consent screen, selects which pages and databases to share, and approves.

​
What agents can do

Read — search the workspace; fetch a page (rendered as markdown), database, or data source; discover data sources and query their rows and views; and search comments, workspace users, and meeting notes. Write (approval-gated, admin-only) — create and update pages, move and duplicate pages, create databases, update data sources, create and update views, and add comments. Every write is restricted to tenant admins and pauses for human approval before it runs.
Notion writes are approval-gated and floored to the tenant-admin role. A non-admin user’s agent can read Notion but cannot invoke any write tool.

​
Notes

  • Single account. Notion does not support linking multiple accounts per user.
  • Async writes. Some markdown page creates and updates run asynchronously; the result returns a task handle to poll. A duplicated page returns immediately as a shell and fills its copied content in the background — re-fetch the page before relying on the body.
  • Scope limits. Only unresolved comment threads are returned, and Notion teamspaces are not exposed by the public API.