notion.com

Notion is a collaborative workspace product for documents, wikis, databases, projects, and related productivity workflows. It also offers enterprise administration features, an AI-agent MCP server, and developer tooling for integrating with workspace content and automation.

4 integrations · MCP · REST · CLI

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

discovered 2mo ago

MCP servers1

Notion MCPdetectedstreamable-http

REST · OpenAPI2

Notion Admin APIdiscoveredrest
Notion APIdiscoveredrest

CLI1

Notion CLIdiscoveredntn

Credentials

Notion internal connection installation access tokenbearerGet token ↗

Create an internal connection in the Developer portal, then open its Configuration tab and copy the Installation access token. You must be a Workspace Owner, and the pages/databases you want the bot to access must be shared with the connection via Add connections or the portal’s content access controls. See Internal connections and Authorization.

Notion personal access token (PAT)bearerGet token ↗

Open the Developer portal, create a personal access token, choose the workspace and capability bundles, then copy the token. PATs act as the user who created them and are intended for personal/developer-owned workflows. See Personal access tokens.

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.

Notion Admin API organization bot tokenbearerGet token ↗

An organization owner can create, edit, or revoke Admin API tokens in the organization console. The Admin API is available only to Enterprise organizations/workspaces. See Admin API introduction.

Notion CLI login session tokenoauth2$ ntn login

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

conventions · 1/8 published

integrations.json✗/.well-known/integrations.json
llms.txt✓https://notion.com/llms.txt
API catalog✗/.well-known/api-catalog
OpenAPI document✗/api/schema/, /openapi.json, /swagger.json, /api/openapi.json, or /v1/openapi.json
MCP server card✗/.well-known/mcp/server-card.json
OAuth protected resource✗/.well-known/oauth-protected-resource
Agent card✗/.well-known/agent-card.json
Agent skills✗/.well-known/agent-skills/index.json

Publish these signals → /publishing