N

notiondevs.notion.site

Notion is a collaborative workspace for documents, wikis, projects, databases, and AI-assisted workflows. Its developer platform lets builders connect external tools, automate workspace operations, deploy Workers, and connect AI agents to Notion.

4 integrations · MCP · REST · CLI

Notion exposes a REST Notion API at `https://api.notion.com`, a separate REST Admin API at `https://api.notion.com/admin`, a hosted MCP server at `https://mcp.notion.com/mcp` (plus SSE), and the `ntn` CLI; all require authentication via Notion-issued tokens or OAuth.

discovered 2mo ago
MCP servers1
REST · OpenAPI2
CLI1
Credentials
Personal access tokenbearerGet 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.

Internal connection installation access tokenbearerGet 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.0oauth2
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.

Organization bot tokenbearerGet token ↗

If your workspace is on Notion Enterprise, an organization owner can create and manage organization bot tokens in the organization console. Use that token for Admin API requests.

Notion CLI login sessionoauth2$ ntn login

Acquired by the CLI — running ntn login opens the auth flow and stores the credential.

conventions · 1/8 published

Publish these signals → /publishing