# Connect your Google Calendar

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

> Link your Google Calendar so your Mucka jobs and appointments sync into it, both ways.

Connect your Google 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 → Google Calendar**](/settings/connections/integrations?sub=google-calendar) and tap **Connect**.

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

- **See and edit events on all your calendars** (so Mucka can write new jobs in)
- **Your email address and basic profile** (so Mucka can show "Connected as ryan@gmail.com")

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

## Personal vs work Google accounts

Mucka works with both:

- **Personal Gmail** (your own calendar)
- **Google Workspace** (your business calendar if you use Google for work)

Connect whichever calendar you want your Mucka jobs to appear in. Most engineers connect their work calendar so their team can see what they're booked on.

## Each engineer connects their own

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

The owner can see (in their own Integrations tab) which engineers have connected, and disconnect them if needed for offboarding.

## What syncs

- **Mucka jobs → Google Calendar** automatically as you schedule them
- **Google Calendar changes → Mucka** when you reschedule or cancel in Google
- **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 Google's own popup alerts.

## Disconnect any time

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

- Removes Mucka's access to your Google Calendar
- Deletes the stored tokens from Mucka
- Stops syncing immediately
- Doesn't delete any events that were already synced

Reconnect any time by going through the Connect flow again.

## Common gotchas

- **"This app isn't verified" warning** from Google. Tap **Advanced** then **Go to Mucka (unsafe)**. Mucka is verified with Google, but Google sometimes shows this warning for newer scopes. Safe to proceed.
- **"Needs calendar permission" after connecting.** On the Google screen there's a tick-box for *"See, edit, share and permanently delete all the calendars"*. If it's left unticked, Mucka can sign you in but can't write jobs to your calendar, so nothing syncs. Tap **Reconnect** and make sure that box stays ticked.
- **"That account has no Google Calendar."** The Google account you signed in with isn't signed up for Calendar at all, so there's nothing for Mucka to sync into. Reconnecting the same account won't change it — connect one that has Calendar turned on.
- **Connected the wrong account.** Disconnect and reconnect, Google will prompt you to pick again.
- **Workspace admin blocks third-party apps.** If you're on a managed Google Workspace, your admin might need to allow Mucka. Send them the help URL and they can whitelist the OAuth client.
- **Token expired** showing in the status. Tap **Reconnect** to refresh, takes 10 seconds.