Notion Connector
Sync pages and databases from your Notion workspace into Knowledge Raven.
What Gets Synced
- Notion pages — Page blocks are extracted and converted to plain text
- Database pages — Individual database entries (pages) are indexed
- Page titles are indexed as searchable metadata
- Nested blocks (paragraphs, headings, lists, toggles, callouts, code blocks) are fully extracted
How to Connect
Step 1 — Open Connectors
In your Knowledge Raven Dashboard, navigate to Connectors and click Add Connector, then select Notion.
Step 2 — Authorize with Notion
You will be redirected to Notion’s OAuth authorization page. Sign in and grant Knowledge Raven access to your workspace.
Knowledge Raven requests user-level access (owner=user) — workspace-level tokens are deprecated by Notion.
Step 3 — Select Pages or Databases
After authorization, Knowledge Raven lists all pages and databases that Notion shares with the integration. Select the content you want to sync.
Step 4 — Select a Knowledge Base
Choose which Knowledge Raven knowledge base the synced content should appear in.
Step 5 — Initial Sync
Knowledge Raven fetches all selected pages recursively, converts blocks to plain text, and indexes the content. Notion API rate limits (3 req/second) mean large workspaces may take a few minutes.
Token Handling
Notion access tokens are long-lived and do not require rotation. Knowledge Raven stores them securely using AES-256 encryption.
Source Deep-Linking
When your agent cites a Notion page, the source_link points to the original Notion page URL.
Troubleshooting
“Content not found” — Make sure the pages/databases were explicitly shared with the Knowledge Raven integration in Notion. Notion’s access model requires explicit page-level sharing.
Nested pages missing — Knowledge Raven traverses child pages recursively. If a child page was added after the initial sync, it will be picked up on the next sync cycle.