Notion Export Connector

The notion_export connector indexes exported Notion workspaces.

Quick Start

hoard add --notion ~/Downloads/notion-export

Or configure manually:

connectors:
  notion_export:
    enabled: true
    export_path: ~/Downloads/notion-export

Exporting from Notion

Open Notion
Go to Settings & Members
Scroll to Export content
Choose format:
- HTML (recommended) — Best structure preservation
- Markdown — Good for text
- CSV — For databases
Click Export
Extract the ZIP file

Configuration Options

connectors:
  notion_export:
    enabled: true
    export_path: ~/Downloads/notion-export

    # Include database exports
    include_databases: true

    # Include CSV database exports
    include_csv_databases: true

    # Rows to sample for schema detection (CSV)
    schema_sample_rows: 200

    # Max tags from schema
    max_schema_tags: 200

    # Chunking settings
    chunk_max_tokens: 400
    chunk_overlap_tokens: 50

Options Reference

Option	Type	Default	Description
`enabled`	bool	`false`	Enable connector
`export_path`	string	required	Path to export directory or ZIP
`include_databases`	bool	`true`	Index database exports
`include_csv_databases`	bool	`true`	Index CSV database exports
`schema_sample_rows`	int	`200`	Rows to sample for schema detection
`max_schema_tags`	int	`200`	Max tags from schema fields
`chunk_max_tokens`	int	`400`	Target chunk size
`chunk_overlap_tokens`	int	`50`	Overlap between chunks

Supported Formats

Format	Extension	Support
HTML	`.html`	Full support
Markdown	`.md`	Full support
CSV	`.csv`	Database rows with schema detection
ZIP	`.zip`	Auto-extracted

What Gets Indexed

For each Notion page/database:

Field	Value
`source`	`notion`
`source_id`	Notion page ID or relative path
`entity_type`	`page` or `database`
`title`	Page title
`uri`	`file:///path/to/export/file.html`
`tags`	`["notion"]` + `["database"]` + schema field tags
`metadata`	Notion ID, database info, CSV schema

CSV Schema Detection

For CSV database exports, the connector:

Reads column headers
Samples rows to infer types (string, integer, date, etc.)
Stores schema in metadata
Adds field names as tags (e.g., field:status, field:due_date)

Page Hierarchy

Notion’s folder structure is preserved. Folders become part of the path stored in metadata.

Search Examples

# Find pages by title
hoard search "project planning" --source notion

# Find database content
hoard search "status:completed"

Updating Content

When Notion content changes:

Export fresh content from Notion
Replace the old export
Run hoard sync

Limitations

Static export — No live sync (export manually)
No comments — Page comments not included
No version history — Only current content

Troubleshooting

”Export not found”

Check path is correct
Ensure export directory or ZIP exists
Try extracting ZIP and pointing to folder

Missing Pages

Check page was included in export
Verify export format (HTML recommended)
Run hoard doctor for diagnostics

Garbled Content

Re-export from Notion
Try HTML format instead of Markdown
Check for special characters in page names