Back to TimeTuna

Calendars

TimeTuna reads your existing calendars to figure out when you are free, and writes new events to one of them. You can connect as many as you need.

Supported calendars

  • Google Calendar: full two-way sync. TimeTuna reads free/busy data and creates events with Google Meet links.
  • Microsoft 365 / Outlook: full two-way sync. TimeTuna creates events in your Outlook calendar and can attach Microsoft Teams links.
  • Zoom: one-way. Used to generate Zoom meeting links on new bookings.
  • iCal feeds: read-only. Paste an https:// ICS URL from any calendar service to block availability without granting OAuth access.

Connecting a calendar

On any booking page editor, open the Calendars tab and click Connect another calendar. Pick the provider, complete the OAuth flow, and the calendar appears in your list. Connections are per-account, so a calendar you connect once is available on every booking page you own.

Approve every permission
During Google or Microsoft sign-in, you will see checkboxes for read and write permissions. TimeTuna needs both, read to know when you are busy, write to create the new event. If you uncheck one, the calendar will not work.

Read vs. write

Per booking page you decide:

  • Which calendars block availability (read). Any event on these calendars marks you unavailable.
  • Which calendar holds new events (write). New bookings are created on this one calendar.

For example, you can have a personal calendar blocking availability without putting work meetings on it.

iCal feeds

To add a calendar without OAuth (a partner's Apple Calendar, a school timetable, a sports team schedule), grab its public .ics URL and paste it under Add iCal feed. TimeTuna re-fetches it periodically. iCal feeds are read-only, they can only block availability.

Disconnecting

Disconnect a calendar from Settings → Connected providers. Existing bookings keep working, but new ones will not check that calendar's availability and will not write to it.

Tokens can expire
If you change your Google or Microsoft password, or revoke access from your provider's security page, TimeTuna loses its token and stops syncing. Reconnect from Connected providers. See OAuth disconnected.