Notion API

REST discovered

Details

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

Authentication

Internal connection installation access token Authorization: Bearer <credential> + Internal connection installation access token Authorization: Bearer <credential> discovered

Internal connection installation access token bearer Get token ↗

In the Developer portal, create an Internal connection as a workspace owner. Open the connection’s Configuration tab and copy the Installation access token. Share pages or databases with the connection before calling the API.

Personal access token bearer discovered Get token ↗

Authorization: Bearer <credential>

Create a token in the Developer portal. Choose a token name, workspace, and capability bundle, then copy the personal access token from the token details. PATs are user-scoped and can be used for the Notion API, Workers, and the CLI via 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.