makenotion.com
Notion is a workspace platform for documents, wikis, projects, and databases. It also provides developer and agent access so external applications and AI tools can read, write, and manage content and enterprise admin resources.
makenotion.com (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` (with SSE fallback), and the `ntn` CLI.
- Notion MCPdetected
- Notion APIdiscovered
- Notion Admin APIdiscovered
- Notion CLIdiscovered
Create a token in the Developer portal. Choose a token name, workspace, and capability bundle, then copy the personal access token from the token details. PATs are user-scoped and can be used for the Notion API, Workers, and the CLI via NOTION_API_TOKEN.
In the Developer portal, create an Internal connection as a workspace owner. Open the connection’s Configuration tab and copy the Installation access token. Share pages or databases with the connection before calling the API.
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.
If your organization is on Notion Enterprise, an organization owner can create and manage Admin API tokens in the organization console. Create or copy an active organization bot token there, then use it for Admin API requests.
$ 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://makenotion.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