The Notion connector is one of the most versatile connectors, supporting three sync modes: workspace-wide search, database query, and parent page tree traversal.
Authentication
OAuth — requires scopes:
read:contentread:database
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Scope | Dropdown | Yes | Workspace / Database / Parent Page |
| Database | Selector / Input | Conditional | Required for Database scope |
| Parent Page | Selector / Input | Conditional | Required for Parent Page scope |
| Search Query | Input | No | Filter pages by title |
| Max Pages | Input | No | Limit the number of synced pages |
Sync Modes
Workspace
Searches all pages in the workspace. Best for comprehensive syncs.
Database
Queries a specific Notion database. Each database row becomes a document.
Parent Page
Syncs all child pages under a specific page. Uses recursive block traversal.
How It Works
- Mode Selection — Different API endpoints per mode: search, database query, or block children
- Block Fetching — Fetches all blocks for each page recursively
- Rich Text Conversion — Converts Notion rich text to plain text
- Block Type Handling — Supports paragraphs, headings, code blocks, equations, to-do items, and more
- Content Deferred — Stubs returned during listing; full block content fetched via
getDocument
Child page fetching uses configurable concurrency to balance speed and rate limits.
Document Format
Pages are converted from Notion blocks:
Page Title
Paragraph text...
# Heading 1
Paragraph...
## Heading 2
More text...
```python
code block- Completed task
- Pending task
## Metadata Tags
| Tag | Type | Description |
|-----|------|-------------|
| Tags | Text | Notion page tags/properties |
| Last Modified | Date | Last edited time |
| Created | Date | Created time |