notion-sync

name	notion-sync
description	Bidirectional sync between workspace knowledge cards and Notion databases. Use when importing/exporting knowledge to Notion, diagnosing Notion API connection issues, or syncing card content. Triggers on Notion-related queries, API integration, or knowledge base synchronization.

Notion Sync — Knowledge Base Integration

Bidirectional synchronization between the workspace knowledge graph (02_distill/) and Notion databases.

When to Use

• Importing knowledge from Notion into workspace cards
• Exporting workspace cards to Notion pages
• Diagnosing Notion API connection/credentials issues
• Setting up initial Notion database mapping

Configuration

Required environment variables:

export NOTION_API_KEY="secret_..."        # Notion integration token
export NOTION_DATABASE_ID="abc123..."     # Target database ID

Usage

Pull from Notion (Notion → knowledge cards)

python3 skills/notion-sync/scripts/notion_sync.py --pull
python3 skills/notion-sync/scripts/notion_sync.py --pull --dry-run   # Preview only

Push to Notion (knowledge cards → Notion)

python3 skills/notion-sync/scripts/notion_sync.py --push
python3 skills/notion-sync/scripts/notion_sync.py --push --dry-run   # Preview only

Diagnose connection

python3 skills/notion-sync/scripts/notion_sync.py --diagnose

Sync Flow

1. Pull: Query Notion DB → map properties to frontmatter → create/update .md cards in 02_distill/
2. Push: Read .md cards → map frontmatter to Notion properties → create/update Notion pages
3. Conflict: If both sides changed since last sync, flag for manual resolution

When NOT to Use

• Graph operations within the workspace (use graph-context skill instead)
• Obsidian-specific queries (Obsidian reads .md files directly, no sync needed)