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 Notion-Version: <credential> discovered

Internal connection installation access token bearer Get token ↗

As a Workspace Owner, open the Developer portal, create an Internal connection, then open its Configuration tab and copy the Installation access token. Share pages/databases with the connection before use via the Content access tab or the page Connections / Add connections UI.

OAuth 2.0 Authorization: Bearer <credential> + OAuth 2.0 Notion-Version: <credential> discovered

OAuth 2.0 oauth2

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.

Personal access token Authorization: Bearer <credential> + Personal access token Notion-Version: <credential> discovered

Personal access token bearer Get token ↗

In the Developer portal, create a personal access token, choose its workspace and capabilities (Notion API and/or Workers), then copy the token. Workspace admins can control PAT creation from Settings & members → Connections. For CLI use, export it as NOTION_API_TOKEN.