Mnemos ↔ Notion Integration

Bridge your Notion workspace with Mnemos for Git-based knowledge management with full version history and offline access.

Architecture

Notion Workspace
    ↓ (export via API/manual)
~/notion-backup/ (Git repo)
├── databases/
│   ├── projects/
│   ├── notes/
│   └── tasks/
├── pages/
│   └── individual-pages/
└── assets/
    └── images/
    ↓ (symlink integration)
mnemos/p/notion/
├── projects/ → ~/notion-backup/databases/projects/
├── notes/ → ~/notion-backup/databases/notes/
└── pages/ → ~/notion-backup/pages/

Quick Setup

1. Get Notion API Token (Optional but Recommended)

Go to Notion Integrations
Create a new integration
Copy the “Internal Integration Token”
Share your databases/pages with this integration

2. Set Up Sync

# Set your Notion token (optional)
export NOTION_TOKEN="secret_xxxxxxxxxxxx"

# Run initial setup
make notion-setup

# Sync your Notion content
make notion-sync

3. Manual Export (Fallback)

If API export doesn’t work:

Go to Notion → Settings & Members → Export content
Choose “Markdown & CSV” format
Download and extract to ~/notion-backup/
Run make notion-sync to integrate with Mnemos

Usage

Regular Sync

# Sync Notion → Git → Mnemos
make notion-sync

# Format and update Mnemos metadata
make fmt

# Push everything to Git
make push

Access in Mnemos

Your Notion content will be available in:

p/notion/projects/ - Project databases
p/notion/notes/ - Note databases
p/notion/pages/ - Individual pages

Git History

All changes are tracked in the ~/notion-backup/ Git repository:

cd ~/notion-backup
git log --oneline  # View sync history
git diff HEAD~1    # See latest changes

Advanced Configuration

Custom Sync Location

# Use custom backup location
./scripts/notion-to-git.sh /path/to/custom/notion-backup

Automated Sync

Add to crontab for automatic daily sync:

# Sync Notion daily at 9 AM
0 9 * * * cd /path/to/mnemos && make notion-sync >/dev/null 2>&1

Docker Export Setup

For API-based export, ensure Docker is available:

# Pull the export tool
docker pull looorent/notion-exporter

Benefits

✅ Git Version Control

Full history of all Notion changes
Diff changes between syncs
Backup and restore capabilities

✅ Offline Access

Work with your Notion content offline
No API rate limits for reading
Fast local search and processing

✅ Mnemos Integration

Use Notion content in Mnemos workflows
Apply Mnemos formatting and metadata
Cross-reference with other knowledge sources

✅ Format Flexibility

Notion content as standard Markdown
Portable between tools
Easy to process with scripts

Troubleshooting

Export Issues

If automatic export fails:

Check your Notion token is valid
Ensure integration has access to pages/databases
Try manual export as fallback

Permission Errors

# Fix permissions if needed
chmod +x scripts/notion-to-git.sh

Missing Dependencies

# Install required tools
brew install git        # macOS
apt install git         # Ubuntu/Debian

File Structure

Your ~/notion-backup/ will contain:

notion-backup/
├── .git/                    # Git history
├── README.md               # Backup info
├── databases/              # Notion databases
│   ├── projects/
│   │   ├── project-a.md
│   │   └── project-b.md
│   ├── notes/
│   │   ├── idea-1.md
│   │   └── research-notes.md
│   └── tasks/
│       └── todo-items.md
├── pages/                  # Individual pages
│   ├── meeting-notes/
│   └── reference-docs/
└── assets/                 # Images and files
    ├── image-1.png
    └── document.pdf

Next Steps

After setting up Notion sync:

Review Content: Check ~/notion-backup/ for exported content
Format Notes: Run make fmt to add Mnemos metadata
Explore Integration: Browse p/notion/ in your Mnemos vault
Set Up Automation: Add to crontab for regular syncing
Backup: Consider pushing ~/notion-backup/ to a Git remote

This integration gives you the best of both worlds: Notion’s collaborative editing with Git’s version control and Mnemos’s structured knowledge management.

README-notion