Repository navigation
v1.0.0 — Stable Release
🎉 notionctl v1.0.0
Declarative Notion database management is now stable.
Commands
| Command | Description |
|---|---|
notionctl init |
Generate starter config |
notionctl import |
Import existing databases from Notion |
notionctl plan |
Preview changes |
notionctl apply |
Create/update/destroy databases |
notionctl diff |
Detect drift from manual Notion edits |
notionctl sync |
Pull Notion state back into YAML |
notionctl validate |
Validate config offline (CI-friendly) |
Highlights
- 19 property types — 100% Notion API coverage
- Symbolic relations — reference databases by name, not UUID
- Destroy detection — databases removed from YAML are auto-detected and archived
- Drift detection — compare remote Notion vs local config
- Structured errors — user-friendly messages with retry for rate limits (429) and server errors (5xx)
- 4 templates — CRM, inventory, project tracker, bug tracker
- CI/CD ready —
--auto-approveflag,validatecommand, example GitHub Actions workflows
Getting Started
go install github.com/radityajay/notionctl@v1.0.0
export NOTION_TOKEN="secret_..."
notionctl init
notionctl plan
notionctl apply