Notion & Google Calendar Sync Script

🚀 LAUNCH WEEK SPECIAL! 🚀

For the first 7 days only, get 33% off and buy the script for just $10! Use code LAUNCH10 at checkout.

🇷🇺 Описание на русском языке находится ниже. 🇬🇧 Full description and instructions in Russian are available below.

Stop manually copy-pasting between Google Calendar and Notion. Forever.

This app creates a seamless, two-way sync between your Google Calendar (and Tasks!) and your Notion database. Automate your workflow, see all your events and tasks in one place, and save hours of tedious work.

✨ Key Features

(Этот список взят из вашего README (source: 16))

• 🔄 Full Two-Way Sync: Changes in Notion update Google Calendar, and vice-versa. Choose your direction: Google → Notion, Notion → Google, or both.
• ✅ Google Tasks Support: Your to-do list from Google Tasks can now live alongside your events.
• 🖥 Simple Desktop App (GUI): No command line needed. An intuitive interface for Windows that anyone can use.
• 🗑 Selective Sync: Use a simple checkbox in Notion to control exactly which items get synced to your calendar.
• 🔒 Secure & Private: Your data is synced directly between Google and Notion on your PC. Your keys and tokens never leave your machine.
• 💸 One-Time Purchase: Buy once, use forever. No monthly subscriptions.

  

  # Calendar ↔ Notion Sync v3.0  
  !
  
  Synchronise Google Calendar **events _and_ tasks** with a Notion database in **both directions** – no coding required.
  
  ---
  
  ## Why you'll love it
  Stop copy-pasting between tools. Calendar ↔ Notion Sync keeps everything up-to-date automatically, lets you tweak the rules, and shows a real-time log so you always know what's happening.
  
  ---
  
  ## Key features
  * 🔄 Two-way sync (Google → Notion, Notion → Google)
  * ✅ Google Tasks support
  * 🖥 Beautiful GUI with *Sync now* & *Cancel* buttons
  * 🌐 Multi-language interface (English & Russian)
  * 🔒 Secure OAuth 2.0 – tokens stay on your PC
  * 📅 Configurable time-horizon (default 30 days)
  * 🗑 Selective sync checkbox inside Notion – uncheck to stop tracking
  * 📜 Verbose log pane & *Save log* button for support
  
  ---
  
  ## Installation (Windows .exe)
  1. Download the ZIP archive from your purchase page.
  2. Extract it to any folder (e.g. `C:\CalendarSync`).
  3. Double-click **`NotionSyncPro.exe`**.  
     No Python, no command line – just run and enjoy!
  
  _First launch may be flagged by Windows SmartScreen. Click **More info → Run anyway**._
  
  ---
  
  ## One-time API setup
  The app needs credentials to access your Google account and your Notion database. Follow the two short guides below – you only have to do this once.
  
  ### 1 · Create a Notion integration
  1. Open `https://www.notion.com/my-integrations` and click **+ New integration**.
  2. Copy the **Internal integration secret** – this is your `NOTION_API_KEY`.
  3. Share the target database with the integration (⋯ → *Add connections*).
  4. Copy the **database ID** from the browser URL.
  
  ### 2 · Enable Google Calendar & Tasks API
  1. Go to [Google Cloud Console](https://console.cloud.google.com/) and create a project.
  2. **Enable APIs & Services → Google Calendar API** ✔.
  3. **Credentials → Create credentials → OAuth client ID → Desktop app**.
  4. Download the JSON and save it as `client_secret.json` next to the app.
  5. (Testing mode) Add your Google account under **OAuth consent screen → Test users**.
  
  ---
  
  ## First run
  1. Launch the app (`NotionSyncPro.exe`).
  2. Open the **Settings** tab and fill in:
     * Notion API key
     * Database ID
     * Path to `client_secret.json` (browse button)
     * Other options as you like
  3. Click **Save**.
  4. Switch to **Status** tab and hit **Sync now**.  
     A browser window will open – sign in to Google and allow access.
  5. Watch the log; when it says **Sync finished – OK** you're done!  Subsequent runs reuse the saved token.
  
  ---
  
  ## Tabs & controls
  | Tab | What you'll find |
  |-----|------------------|
  | **Status** | *Sync now*, *Cancel*, log pane, last-sync timestamp, *Save log* |
  | **Settings** | All API keys & sync options.<br/>– **Connections** frame: Notion / Google creds & *Check* buttons<br/>– **Synchronization** frame: direction, conflict policy, days ahead, checkboxes<br/>– **Config management** frame: Import / Export / Save current setup |
  | **About** | Version info & link to GitHub |
  
  Hover over any drop-down to see a quick tooltip explaining the option.
  
  ---
  
  ## FAQ / Troubleshooting
  | Problem | Solution |
  |---------|----------|
  | *Error 403: access_denied* when authorising Google | Add your account to **Test users** on the OAuth consent screen and wait a few minutes. |
  | *Validation error "Name is not a property that exists"* | Column names in Notion don't match the defaults. Rename columns or change the mapping in Settings. |
  | *HTTP 429 Too many requests* | You hit Notion's rate limit. Run the sync less often or increase the "Days ahead" window. |
  | Some events don't copy to Google | Make sure the Notion page has the **Sync to Calendar** checkbox ticked. |
  | Want to stop syncing an old event | Untick the checkbox; the entry will be deleted from Google on the next sync. |
  
  Still stuck? Save the log (`Status → Save log`) and send it to support.
  
  ---
  
  ## License
  Released under the MIT License – see `LICENSE`.

  🇷🇺 Полное описание и инструкция на русском языке

  Автоматически синхронизирует события Google Calendar **и** задачи Google Tasks с вашей базой данных Notion — в обе стороны, без командной строки и настроек Python.
  
  ---
  
  ## Зачем это нужно
  Перестаньте вручную копировать события туда-сюда. Приложение само поддерживает равенство данных и показывает понятный лог в реальном времени.
  
  ---
  
  ## Ключевые возможности
  * 🔄 Двусторонняя синхронизация (Google ↔ Notion)
  * ✅ Поддержка Google Tasks
  * 🖥 Современный GUI с кнопками *Sync now* и *Cancel*
  * 🌐 Интерфейс на русском и английском
  * 🔒 Безопасный OAuth 2.0 — токены остаются на вашем ПК
  * 📅 Гибкий горизонт (по умолчанию 30 дней вперёд)
  * 🗑 Чекбокс **Sync to Calendar** в Notion для выборочной синхронизации
  * 📜 Подробный лог + кнопка *Save log* для отладки
  
  ---
  
  ## Установка (Windows)
  1. Скачайте ZIP-архив на странице покупки.
  2. Распакуйте в удобную папку, например `C:\CalendarSync`.
  3. Дважды щёлкните **`NotionSyncPro.exe`**.  
     Python, Git и терминал не требуются.
  
  > При первом запуске SmartScreen может показать предупреждение. Нажмите **More info → Run anyway**.
  
  ---
  
  ## Одноразовая настройка API
  Приложению нужны ключи доступа к Notion и Google. Сделайте это один раз.
  
  ### 1 · Интеграция Notion
  1. Перейдите на <https://www.notion.com/my-integrations> → **New integration**.
  2. Скопируйте **Internal integration secret** → это `NOTION_API_KEY`.
  3. Поделитесь базой с интеграцией (*Share → Add connections*).
  4. Скопируйте **ID базы** из URL.
  
  ### 2 · Включите Google Calendar & Tasks API
  1. Войдите в [Google Cloud Console](https://console.cloud.google.com/) и создайте проект.
  2. **APIs & Services → Library → Google Calendar API → Enable**.
  3. **Credentials → Create credentials → OAuth client ID → Desktop app**.
  4. Скачайте JSON и сохраните рядом с приложением как `client_secret.json`.
  5. Если приложение в режиме *Testing* — добавьте свой аккаунт в **OAuth consent screen → Test users**.
  
  ---
  
  ## Первый запуск
  1. Откройте приложение.
  2. Перейдите на вкладку **Settings** и заполните:
     • Notion API Key  
     • Database ID  
     • Путь к `client_secret.json` (кнопка Browse)  
     • При необходимости измените другие параметры
  3. Нажмите **Save**.
  4. На вкладке **Status** щёлкните **Sync now**.  
     Откроется браузер для авторизации Google.
  5. После сообщения **Sync finished – OK** настройка завершена. Следующие запуски проходят без авторизации.
  
  ---
  
  ## Что на вкладках?
  | Вкладка | Содержимое |
  |---------|------------|
  | **Status** | *Sync now*, *Cancel*, окно лога, время последней синхронизации, кнопка *Save log* |
  | **Settings** | • **Connections** — ключи Notion / Google и кнопки *Check*<br/>• **Synchronization** — направление, политика конфликтов, дни вперёд, чекбоксы<br/>• **Config management** — Import / Export / Save |
  | **About** | Версия приложения и ссылка на GitHub |
  
  Совет: наведите курсор на выпадающие списки — появится подсказка.
  
  ---
  
  ## Частые вопросы
  | Вопрос | Ответ |
  |--------|-------|
  | Ошибка *403: access_denied* при авторизации Google | Добавьте свой аккаунт в **Test users** на странице OAuth consent и подождите пару минут. |
  | Сообщение *Validation error "Name is not a property that exists"* | Названия столбцов в Notion не совпадают с ожидаемыми. Переименуйте их или поменяйте mapping в настройках. |
  | Ошибка *HTTP 429 Too Many Requests* | Вы достигли лимита Notion. Запускайте синхронизацию реже или сократите диапазон «Days ahead». |
  | Событие не удаляется из Google после снятия галочки | Убедитесь, что чекбокс **Sync to Calendar** снят и нажмите *Sync now* — событие исчезнет. |
  | Нужно прекратить синхронизацию базы | Нажмите *Cancel* во время процесса или закройте приложение — данные не будут испорчены. |
  
  Если проблема не решена — сохраните лог и отправьте нам для анализа.
  
  ---
  
  ## Лицензия
  MIT License (см. файл `LICENSE`).