notion.com
Notion is a collaborative workspace for documents, wikis, projects, databases, and related team workflows. It also offers AI features and enterprise administration capabilities for managing workspace and organization resources.
Notion exposes two HTTP APIs on api.notion.com (the main Notion API and enterprise-only Admin API), a hosted OAuth-protected MCP server on mcp.notion.com with streamable HTTP and SSE transports, and the `ntn` CLI.
- Notion MCPdetected
- Notion Admin APIdiscovered
- Notion APIdiscovered
- Notion CLIdiscovered
In the Developer portal, create a personal access token (PAT), choose its workspace and capability bundle, and copy the token. PATs are user-scoped and can include Notion API and/or Workers capabilities, subject to workspace policy.
As a workspace owner, open the Developer portal connections page, create an Internal connection, then open its Configuration tab and copy the Installation access token. Share the needed pages/databases with the connection before using it.
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.
On an Enterprise plan, an organization owner opens the organization console and creates an organization bot token for the Admin API. Organization owners can create, edit, or revoke active tokens there.
$ 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