# Connect your Microsoft 365 Calendar

Source: https://help.mucka.ai/integrations/set-up-microsoft-calendar
Category: Integrations
Last updated: 2026-09-02

> Link your Outlook or Microsoft 365 calendar so your Mucka jobs and appointments sync into it, both ways.

Connect your Microsoft 365 (or personal Outlook.com) calendar and your Mucka jobs and appointments land in it automatically, as you book them. Change something either side and the other keeps up.

## Connect your account

Head to [**Settings → Connections → Integrations → Microsoft 365**](/settings/connections/integrations?sub=microsoft-365) and tap **Connect**.

Microsoft asks you to sign in and grant Mucka access to your calendar. The permissions you're granting:

- **Read and write your calendars** (so Mucka can add jobs)
- **Sign in and read your profile** (so Mucka can show "Connected as ryan@business.co.uk")
- **Maintain access to data you've given Mucka** (so the connection doesn't break overnight)

Approve and Microsoft sends you back to Mucka with a "Connected" confirmation.

## Personal Outlook vs work Microsoft 365

Mucka works with both:

- **Personal Outlook.com / Hotmail / Live** accounts
- **Microsoft 365 work accounts** (the one your business pays for)

Same connect button, Microsoft figures out which one you're using when you sign in.

## Each engineer connects their own

Calendar connections are per-user. Every engineer connects their own Microsoft account. The owner doesn't connect everyone, each person picks their own calendar.

The owner can see which engineers have connected and disconnect them if needed.

## What syncs

- **Mucka jobs → Outlook Calendar** automatically as you schedule them
- **Outlook changes → Mucka** when you reschedule or cancel in Outlook
- **Cancel in one, cancel in both** so you don't end up double-booked
- **Personal appointments and time off** both ways, so nothing gets booked over them — not even by the AI receptionist

Reminders you've set on a Mucka appointment come across as Outlook's own alerts.

## Disconnect any time

Same page has a **Disconnect** button. Tapping it:

- Removes Mucka's stored tokens for your account
- Stops syncing immediately
- Doesn't delete events that were already synced

A quirk worth knowing: Microsoft (unlike Google) doesn't expose an API for apps to revoke their own access. If you want to revoke Mucka's access on Microsoft's side as well, head to [Microsoft account → Privacy → Apps and services](https://account.microsoft.com/consent/manage). Disconnecting in Mucka is enough for most people.

## Common gotchas

- **Work account blocked by admin.** Microsoft 365 admins can lock down which third-party apps employees can connect. If you see "Need admin approval", ask your IT person to allow Mucka.
- **"Needs calendar permission" after connecting.** On the Microsoft consent screen, leave all the requested permissions ticked. If the calendar permission isn't granted, Mucka can sign you in but can't write jobs to your calendar, so nothing syncs. Tap **Reconnect** and accept the full set.
- **Connected the wrong account.** Disconnect and reconnect. Microsoft remembers your last sign-in, hit **Use another account** on the sign-in screen.
- **Multi-factor auth (MFA) prompt every reconnection.** Normal. Microsoft adds MFA on every fresh OAuth grant. Once connected, you stay connected.
- **Tenant restrictions.** If you're on a tightly-managed corporate tenant, your IT may require Mucka to be added as a service principal. Send them the help URL.