ICalSync docs
Help / ICalSync / Getting started

Getting started

ICalSync copies the events of your other calendars (Outlook, iCloud, another Google account, Airbnb, Booking.com or any iCal link) into Google Calendar and keeps them up to date. It can also copy your Google events back (two-way).

  1. Open the ICalSync listing on the Google Workspace Marketplace and choose Install. Google shows the permissions the add-on needs: calendar access, so it can create and update the events you ask for.
  2. Open Google Calendar and click the ICalSync icon in the right side panel.
  3. Click Connect a calendar and follow the steps below.

The Get started steps of ICalSync

Administrators can install it for a whole domain from the same listing.

Connect a calendar

Connect a calendar asks where the calendar is. Accounts you connect once appear under Connected accounts: click one to sync another of its calendars, or Disconnect it.

Where is the calendar?

Outlook / Microsoft 365

  1. Choose Outlook / Microsoft 365.
  2. A page names the ICalSync account the calendar will be added to. Check it is yours, then Continue.
  3. Sign in with Microsoft (Outlook.com, Hotmail or a work account) and accept.
  4. Close the window: ICalSync asks you to pick the calendar to sync.

Work accounts

Some companies and schools only let their administrator approve apps. If Microsoft says Need admin approval, see Outlook admin approval, or use the publish link of your Outlook calendar instead.

Outlook admin approval

Microsoft shows Need admin approval when your organization does not let its users approve apps that read their calendar. ICalSync is published by a verified publisher (Futzs); an IT administrator approves it once for the whole organization.

You have two options:

  1. Ask your IT admin to approve ICalSync (steps below), then connect Outlook again. Best choice: two-way sync becomes possible.
  2. Use the calendar link (ICS) of your Outlook calendar. No approval needed, works right away, one-way only (Outlook to Google):

    1. In Outlook on the web, open Settings › Calendar › Shared calendars.
    2. Under Publish a calendar, pick your calendar and Can view all details, then Publish.
    3. Copy the ICS link (not the HTML one).
    4. In ICalSync, Connect a calendar › Calendar link (ICS), paste the link and save.

    Some organizations also turn publishing off; then only option 1 is left.

For the IT administrator:

  1. Open the approval link and sign in with an administrator account (Cloud Application Administrator, Application Administrator or Global Administrator): approve ICalSync for your organization.
  2. Review and accept the permissions:
    • Sign you in and read your profile (User.Read), to show which account is connected;
    • Have full access to your calendars (Calendars.ReadWrite), to read events and, for two-way syncs only, write tagged copies;
    • Maintain access to data you have given it access to (offline_access), so syncs run in the background;
    • View your email address and Sign you in (email, openid).
  3. A page confirms the approval. Users can now connect Outlook.

App details: name ICalSync, application (client) ID 907d5b97-5165-496a-9bc2-b2948bc7703d, publisher Futzs (verified). ICalSync stores no event content; see the privacy policy.

If Outlook is not in the list yet, use the calendar link of your Outlook calendar: Outlook on the web › Settings › Calendar › Shared calendars › Publish a calendar, choose Can view all details, publish and copy the ICS link.

Another Google account

Sync a calendar of another Google account (for example a personal Gmail into your work account) with its private iCal link:

  1. In the other account, open Google Calendar › Settings › the calendar › Integrate calendar and copy the Secret address in iCal format.
  2. In ICalSync, choose Connect a calendar › Calendar link (ICS) and paste the link.

The copy is one-way (the other account into this one). Keep the secret address private: anyone with it can read the calendar.

Apple iCloud

Apple does not let other apps use your Apple ID password, so ICalSync uses an app-specific password:

  1. Open account.apple.com › Sign-In and Security › App-Specific Passwords.
  2. Create one named ICalSync and copy it (format xxxx-xxxx-xxxx-xxxx).
  3. In ICalSync choose iCloud, enter your Apple ID and that password, then Connect.
  4. Pick the calendar.

Connect iCloud

You can revoke the password at any time on the same Apple page; ICalSync then shows Account disconnected until you connect again.

For any calendar that can publish an iCal link: Airbnb, Booking.com, Vrbo, Expedia, school and sports schedules, booking tools, or an Outlook calendar without sign-in.

  1. Find the link in the system that owns the calendar. It sits under a menu called share, publish, subscribe, export or sync, and usually ends in .ics.
  2. Choose Calendar link (ICS), paste it, give it a short name and pick the Google calendar to write to.
  3. Click Sync.
Source Where the link is
Outlook / Microsoft 365 Settings › Calendar › Shared calendars › Publish a calendar › ICS link
Another Google Calendar Settings › your calendar › Integrate calendar › Secret address in iCal format
Apple iCloud Share the calendar as a Public Calendar and copy the link (webcal:// works)
Airbnb, Booking.com, Vrbo, Expedia See Rental properties

Connect a calendar link

One-way or two-way

For an account calendar (Outlook, iCloud), the form asks for a Direction:

  • One-way copies the calendar into Google.
  • Two-way also copies the events you create in the chosen Google calendar to the other calendar. It needs a calendar that account can write to.

Choose the direction

How two-way behaves:

  • Edit or delete an event in the calendar where you created it: its copy follows within minutes.
  • A copy edited by hand is overwritten at the next change of its original; a copy deleted by hand comes back.
  • Events ICalSync copied are marked, so they never bounce back and forth.
  • Repeating Google events are copied as single occurrences, for the next 12 months.
  • Deleting the synchronization also removes its copies.

Advanced options (hide titles, descriptions or locations, mark as private, add an identifier like [Work]) apply to the copies in both directions.

Manage your calendars

The home card lists your synchronizations with your plan’s limit. Under each one:

Button What it does
✏️ Edit Change the name and options
⏸ Pause / ▶ Resume Stop syncing for a while; a paused calendar frees its place in your plan
🗑 Delete Asks first, then removes the events it copied
🔄 Sync now Runs it immediately and refreshes the card

A ⇄ arrow marks a two-way synchronization.

Your synchronizations

Rental properties

For hosts with the same place on several channels: ICalSync blocks the dates booked on one channel on all the others, and warns you by e-mail about double bookings.

  1. Connect each channel’s calendar link (export, below) with Calendar link (ICS). ICalSync recognises the channels and hides guest names.
  2. Open Rental properties on the home card, add a property and tick its calendars.
  3. Under Export links, copy the link labelled Paste in Airbnb into Airbnb’s import setting, Paste in Booking.com into Booking.com, and so on.

A property and its export links

Channel Export (copy into ICalSync) Import (paste the ICalSync link)
Airbnb Calendar › your listing › Availability › Connect calendars › Connect to another website › copy the Airbnb calendar link Same screen › calendar address field, name it ICalSync
Booking.com Extranet › Rates and Availability › Sync calendars › Add calendar connection Same page, name it ICalSync
Vrbo Calendar › Import and export › export link Import a calendar
Expedia Partner Central › Rooms and rates › Calendar sync Same page

Channels refresh imported calendars every 30 minutes to a few hours; ICalSync cannot make them faster. Direct bookings kept in a Google Calendar can be added to the property too: add its secret iCal address as a calendar link.

Plans and trial

Every new account gets a 14-day trial with all features. When it ends, nothing is deleted: your first calendar keeps syncing once a day and the others pause until you choose a plan in Dashboard › Plans & pricing.

Trial ended

Troubleshooting

Open the link in a browser. If it downloads a text file starting with BEGIN:VCALENDAR, the link is fine; check the Google calendar you picked. If it asks you to sign in, it is a web page link, not the ICS link.

Account disconnected

The connected account refused access: the app-specific password was revoked, the Microsoft or Google access was removed, or the password changed. Open Connect a calendar, click the account and connect it again.

Events are duplicated

The same calendar is probably subscribed in Google (From URL) and synced by ICalSync. Remove the subscription and keep the sync.

Times are off by an hour

Some systems publish calendars without time zone information. Check the time zone of the source and of the Google calendar.

Still stuck? E-mail support-icalsync@futzs.com.