OrgMCP/ docs
Sign up
Documentation
Get started
Connectors
MCP integration
Reference
Enterprise
Misc

Notion connector

Notion is generally available on wave2 (Team+; Free cannot install). Two flavours: Notion OAuth (recommended for workspaces) and an internal integration token (secret_… / ntn_…). Test connection fails when the integration has been shared 0 pages or databases — a valid token is not enough. Use notion_diagnose to see the workspace name and visible counts.

Option A — Notion OAuth (recommended)

  1. In the OrgMCP admin console, open Connectors → Add → Notion.
  2. Click Connect to Notion. You will be bounced to Notion's OAuth consent screen. Pick the workspace and approve the integration.
  3. Notion returns you to /api/oauth-tenant/notion/callback; the credential is stored KMS-encrypted in the per-tenant connector_credentials row.
  4. Share at least one page or database with the integration: ••• → Connections → add this integration. Sharing a parent page shares its children.
  5. Click Test connection. Green requires ≥1 shared page or database. Then add a notion_workspace source on the Index tab (flat list).

Option B — Internal integration token

  1. In Notion: Settings → Connections → Develop or manage integrations → New integration. Copy the secret_… / ntn_… token.
  2. In the OrgMCP admin console, paste the token under Connectors → Add → Notion.
  3. Share pages via Connections the same way as OAuth, then Test. Zero shared resources fails (not a green Connected).

What gets indexed

  • Pages and databases the integration can see via workspace-wide search (notion_workspace), rendered as Markdown, capped at 1000 objects.
  • Hitting the cap writes a Partial sync warning. An empty crawl writes an exact emptyReason (nothing shared / query filter empty / unrendered Markdown) — not a silent green sync.

What does not get indexed

  • Pages that were never shared with the integration (Notion's default).
  • Comments, databases as structured rows (the page/database object is the document).

Audience visibility

The workspace is one knowledge source with its own audience. Typical pattern: whole-tenant for the company wiki, or a group for a private space. Personal Notion installs are not a separate product surface — use the tenant connector and lock the source audience (see Personal connectors for other kinds).