Setup Guide

How to connect a Notion database and sync it to your calendar app, step by step.

1Connect your Notion workspace

From Your calendars, click "Connect another database" and authorize NotionCal to access your workspace. You pick exactly which database to share on Notion's own page — nothing else is touched.

Connect your Notion workspace screen

2Choose which columns to sync

A Notion database has no fixed shape, so NotionCal has to be told which of your columns holds what. You pick this when you connect a database, and you can change it afterwards from Column mapping on any calendar.

The column mapping panel: a Date dropdown marked required, alongside dropdowns for event title, location, description, priority, busy/free, reminder, travel time, repeat and attendees

The date column is the one that matters. It decides which rows become events at all: a row with that column empty is not synced. If the column holds a range rather than a single date, the event spans it.

When your database has only one date column it is chosen for you. When it has several — a deadline, a created date, an archive date — NotionCal asks rather than guesses, because picking the wrong one leaves the calendar silently empty.

Everything else is optional. A field you leave unmapped simply does not appear on the event; nothing breaks. Each dropdown only lists columns of a type that field can read:

  • Event title — your database's title column.
  • Location — text or URL.
  • Description — text.
  • Priority — a select whose options are High, Medium or Low.
  • Busy / free — a checkbox, or a select with Busy and Free.
  • Reminder — a number: minutes before the event.
  • Travel time — a number: minutes.
  • Repeat — a select with Daily, Weekly, Monthly or Yearly.
  • Attendees — a people column, or text with addresses separated by commas.

To change it later, open Column mapping on the calendar in your dashboard:

A calendar card on the dashboard, showing the Column mapping link next to View sync log

Column names can be in any language — only the option values above are matched by name, and those are case-insensitive. If a field stays empty on your events, it is usually because the column holds a different type than the list expects.

3Your calendars dashboard

Each Notion database you pick shows up as its own calendar here, alongside one shared "Account-wide CalDAV access" credential that gives a calendar app access to every calendar you own at once.

Your calendars dashboard

4Get your CalDAV credentials

Click "Regenerate" (or "Generate account-wide access" the first time) to reveal a CalDAV URL, username, and password. The password is shown only this once — copy it now, or use the iOS download button below right away.

Account-wide CalDAV credentials revealed, with a Download for iOS link

5iPhone or iPad: one-tap setup

Tap "Download for iOS (2-way sync)" right after generating your password. Safari asks to download a configuration profile — tap "Allow".

Safari asking to allow the configuration profile download

iOS switches to Settings and shows "Profile Downloaded" — tap it, then tap the profile again to review it.

Settings showing the Profile Downloaded row

Tap "Install" in the top-right corner. You'll see an "Unsigned Profile" warning — that's expected, not an error. NotionCal doesn't pay for a code-signing certificate, and neither do most small CalDAV services; the warning doesn't stop the account from working. Tap "Install" again to confirm.

iOS unsigned profile warning, safe to install anyway

Done — the profile installs and every calendar you own now appears in Apple Calendar, fully two-way: events you create or edit there sync back to Notion, and vice versa.

Profile Installed confirmation screen

Prefer to type it in yourself? Go to Settings → Apps → Calendar → Accounts → Add Account → Other → Add CalDAV Account and enter the CalDAV URL, username, and password from step 4 (leave off https:// in the Server field — iOS adds it automatically).

iOS manual CalDAV account form with server, username, password and description filled in

6Android: DAVx5

Android has no OS-level equivalent to the iOS profile above — the standard way to get two-way CalDAV sync is the DAVx5 app. Install it, tap "Add account", then either:

  • Open your phone's Camera app (or any QR scanner) and point it at the Android (DAVx5) code from step 4 — it'll offer to open DAVx5 with the server and username already filled in; you still type the password yourself.
  • Or in DAVx5 choose "Login with URL and user name" and type the three fields from step 4 in by hand.
DAVx5 login screen with server and username pre-filled after scanning the QR code

Same result as iOS: every calendar you own shows up, fully two-way.

7Other apps: Google Calendar, Thunderbird, or any CalDAV client

Copy the three fields from step 4 — CalDAV URL, username, password — into your app's own "Add CalDAV account" or "Subscribe to calendar" screen:

  • Two-way sync (create/edit/delete from your calendar app): use an app that supports adding a full CalDAV account, e.g. Thunderbird.
  • Read-only: most calendar apps also let you "subscribe" to a calendar by URL — paste a single calendar's URL there for a live, view-only feed.

8Or just use the built-in calendar

No calendar app needed — click "Open calendar" on any calendar in your dashboard to view, create, and edit events directly in your browser.

Built-in browser calendar view