notion.com
Notion is a workspace platform for documents, databases, collaboration, and internal tooling. It also offers enterprise administration features for managing organization-level Notion resources.
Notion exposes a REST Notion API, a separate enterprise Admin API, a hosted MCP server at mcp.notion.com, and the `ntn` CLI; all require authentication.
- Notion MCPdetected
- Notion APIdiscovered
- Notion Admin APIdiscovered
- Notion CLIdiscovered
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.
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.
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.
An organization owner can create the token in the organization console. Create an organization bot token, choose the needed Admin API scopes, then copy the token secret. The Admin API is only available for enterprise organizations/workspaces.
$ ntn loginAcquired 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