While

Quickstart

Deploy and configure your sync in under 5 minutes

This guide walks you through deploying your own While instance.

Prerequisites

Before starting, you'll need:

Vercel Account

Sign up at vercel.com (free tier is sufficient)

Google Cloud Project

Create a project at console.cloud.google.com and select External user type

Notion Integration

Create an integration at notion.so/my-integrations

Step 1: Create Google OAuth Credentials

  1. Go to APIs & Services > Library in Google Cloud Console
  2. Enable the Google Calendar API

If the API is already enabled, you'll see "Manage" instead of "Enable". No action needed.

  1. Go to APIs & Services > OAuth consent screen
  2. Configure as External with your email as test user
  3. Go to Credentials > Create Credentials > OAuth client ID
  4. Select Web application and configure:

Authorised JavaScript origins:

https://your-app.vercel.app
http://localhost:3000

Authorised redirect URIs:

https://your-app.vercel.app/api/auth/callback/google
http://localhost:3000/api/auth/callback/google

You'll update these URIs with your actual Vercel domain after deployment.

Detailed Google OAuth Setup →

Token Expiration

OAuth tokens expire every 7 days in "Testing" mode. You'll need to re-authenticate weekly unless you publish your OAuth app. Publishing is recommended for a smoother experience.

Step 2: Create Notion Integration

  1. Go to My integrations in Notion
  2. Click New integration
  3. Fill out name, select workspace, keep type as Internal
  4. Click Save
  5. Click Configure integration settings in the popup
  6. Verify Read, Update, and Insert capabilities are enabled
  7. Copy the Internal Integration Secret
  8. Connect the integration to your calendar database

Detailed Notion Setup →

Step 3: Deploy to Vercel

Click the button below to deploy:

Deploy with Vercel

During deployment, you'll need to provide these environment variables:

VariableDescriptionYour Value
Random string for session encryption
From Google OAuth credentials
From Google OAuth credentials
Comma-separated emails, spaces trimmed (e.g., you@gmail.com, admin@company.com)

Redis storage is automatically provisioned via the deploy button — no manual setup needed.

Generate secrets

openssl rand -base64 32

Detailed Deployment Guide →

Step 4: Complete Setup Wizard

  1. Open your deployed app URL
  2. Follow the setup wizard to:
    • Sign in with Google (grants calendar access automatically)
    • Select your calendar
    • Enter your Notion integration token
    • Select your database
    • Configure field mappings
    • Test the connection

Step 5: Update OAuth Redirect URI

After deployment, update your Google OAuth credentials with your actual Vercel domain:

https://your-app-name.vercel.app/api/auth/callback/google

You're Done!

Your events will now sync bidirectionally between Notion and Google Calendar.

Field Mapping

Customize how properties sync

Troubleshooting

Fix common issues

Introduction

Keep your Notion calendar database and Google Calendar in perfect sync

Architecture

Technical overview of how the sync works

On this page

PrerequisitesVercel AccountGoogle Cloud ProjectNotion IntegrationStep 1: Create Google OAuth CredentialsStep 2: Create Notion IntegrationStep 3: Deploy to VercelStep 4: Complete Setup WizardStep 5: Update OAuth Redirect URIYou're Done!