Notion API

REST discovered

Details

URL: https://api.notion.com
Docs: https://developers.notion.com/reference/intro

Authentication

Notion internal connection installation access token bearer discovered Get token ↗

Authorization: Bearer <credential>

Create an internal connection in the Developer portal: choose Internal connections, create a new connection, then open its Configuration tab and copy the Installation access token. Share the needed pages/databases with the connection via Content access or the page’s Connections menu before using the token.

Notion personal access token (PAT) bearer discovered Get token ↗

Authorization: Bearer <credential>

Open the Developer portal, create a personal access token, choose its workspace and capabilities, then copy the token secret. PATs are user-scoped and use the creator’s page permissions. For CLI unattended use, export it as NOTION_API_TOKEN.

OAuth 2.0 oauth2 discovered

Authorization: Bearer <credential>

OAuth 2.0 — self-onboarding

Point your MCP client at the server URL and approve access in the browser. The server accepts a Client ID Metadata Document (CIMD), so the client authenticates with its own hosted URL as the client_id — nothing to register.