Sync your Microsoft Teams calendar
Connect your Microsoft 365 account, then choose whether each Tookan calendar should sync with Microsoft Calendar.
All documentationBefore you start
The calendar shown in Teams is your Microsoft 365 (Outlook) calendar. Use the work or school account that owns it. Your organisation may require administrator consent. Tookan calendars are disabled by default and can be enabled separately.
1. Connect your Microsoft account
- Open the integration
In Tookan, open Settings > Integrations > Microsoft Teams, then click Connect a Microsoft account.
- Allow access
Sign in with the Microsoft 365 account used in Teams. Review the calendar permissions and accept them for your account. Only approve consent for the whole organisation if you are authorised to do so.
- Check the account
The connected email address appears at the top of the page. You can then choose which Tookan calendars to sync.
2. Choose none, one or several calendars
Each Tookan calendar has its own Sync direction setting. Unconfigured calendars default to None.
| Your choice | What to do |
|---|---|
| No calendars | Leave None on every Tookan calendar and click Save. You do not need to choose a Microsoft calendar; the other settings are hidden. |
| One calendar | Choose a direction on the Tookan calendar you want, select its Microsoft calendar, then save. Leave the others on None. |
| All or several | Choose a direction and Microsoft calendar on each Tookan calendar you want to sync, then save each card separately. Several Tookan calendars can use the same Microsoft calendar. |
3. Set the sync direction
| Direction | Effect |
|---|---|
| None | No sync for this Tookan calendar; no Microsoft calendar is required. |
| Microsoft Calendar → Tookan | Busy Microsoft events are imported into Tookan. Tookan appointments are not sent to Microsoft. |
| Tookan → Microsoft Calendar | Tookan appointments are copied to the selected Microsoft calendar. Microsoft events are not imported. |
| Tookan ↔ Microsoft Calendar | Tookan appointments are exported and busy Microsoft events are imported. |
- For a direction that imports Microsoft events, select the Tookan availabilities that should take them into account in suggestions.
- A read-only Microsoft calendar can be used for Microsoft Calendar → Tookan, but not for a direction that exports Tookan appointments.
- Imported Microsoft events are read-only in Tookan: edit them in Microsoft Calendar.
4. Save and check
- Save each calendar
Click Save in the relevant Tookan calendar card. For None, Save remains available without selecting a Microsoft calendar.
- Run a sync
Click Sync now at the top of the page. The summary shows calendars processed, appointments imported or exported, failures and deferred operations. Only enabled calendars are processed.
- Check an appointment
Check a busy event in the importing Tookan calendar or a Tookan appointment in the exporting Microsoft calendar, depending on the selected direction.
Why is Microsoft authorisation refused?
Your organisation may restrict consent to applications. Ask its administrator to allow the Tookan Calendar app for your account. If access has expired, click Renew Microsoft authorisation.
Why is a calendar missing or disabled?
Check that the connected Microsoft account can access it. A read-only shared calendar cannot receive Tookan appointments; choose Microsoft Calendar → Tookan or an editable calendar.
What happens if I change direction or calendar?
Tookan removes copies that no longer match the setting and keeps original appointments. Changing a Microsoft calendar affects only the Tookan calendar you save.