Notion
ConnectionMCPOpenAPISearch and edit Notion pages and databases over MCP or OpenAPI.
Install
Connections live under agent/connections/. Auth is brokered by , so install the framework and the Connect SDK:
Quick start
Create agent/connections/notion.ts. The connection name is derived from the filename:
Connect owns the OAuth flow, and each end-user authorizes in their own browser before their first tool call.
Configure
Create the connector, link it to your project, and pull OIDC locally:
For JWT bearer, principalToSubject controls the asserted subject. The default maps app principals to { type: "app" } and user principals to { type: "user", id, issuer }.
The OpenAPI setup sends the required Notion-Version header; bump it as Notion ships new API versions.
See the for principal types, headers, approval, and tool filters.