# Google Integration Connect your Google Calendar to see your meetings and appointments in Zaphiri while you plan. The Google integration puts the time already committed in your calendar beside your tasks. > [!quote] The whole day in view > See your meetings and tasks together for ==realistic daily planning== that accounts for all your time commitments. ## How the Google integration works The Google integration has **read-only access** to your Google Calendar: ### Calendar view - **One-way data flow**: Google Calendar events appear in Zaphiri - **No writing back**: Zaphiri doesn't create or change Google Calendar events - **Live updates**: calendar changes in Google appear in Zaphiri on their own - **Multiple calendars**: connect all your Google calendars so nothing is hidden ### Meeting Automation Zaphiri can import meetings from your Google Calendar into your daily plan: - **Auto-import**: meetings appear without manual entry - **Fine control**: turn auto-import on or off for whole calendars or for specific recurring events - **Easy to spot**: imported meetings show a calendar icon and their start and end times - **Live updates**: changes to calendar events sync on their own ### How it helps your planning - **Avoid overcommitting**: see meeting time while you plan tasks - **Realistic plans**: count calendar events in your daily capacity - **Context awareness**: see the switches between meetings and focused work - **Around your calendar**: plan tasks around the commitments already in your calendar > [!tip] What you get > **The whole day in one view**: see meetings beside your tasks > **Accurate capacity**: meeting time counts in your daily capacity > **Easier transitions**: leave room between meetings and focused work > **Realistic expectations**: avoid planning deep work on busy meeting days ## Setting up the Google integration ![[integrations-calendar-section.png]] Google Calendar connects from **Settings → Integrations**, under Calendar Integration. Only the events you select are imported. ### Initial connection 1. **Open Zaphiri Settings**: select the settings icon in your sidebar 2. **Go to Integrations**: select the Integrations section 3. **Go home**: return to your main Week view (home screen) 4. **Find the Google icon**: look for the Google integration icon in the right side panel 5. **Select to connect**: select the Google icon to start connecting 6. **Sign in to Google**: sign in with your Google account 7. **Grant calendar permissions**: allow Zaphiri to read your Google Calendar ### Required permissions Zaphiri asks Google for minimal permissions: > [!note] Google permissions required > **Calendar read access**: view your calendar events and details > **Basic profile info**: name and email to identify your account > **No write permissions**: Zaphiri cannot create, change or delete calendar events > **No email access**: Zaphiri does not read your Gmail or other Google services ## Understanding the calendar integration ### What appears in Zaphiri Your Google Calendar events show in Zaphiri with: > [!success] Calendar event display > **Event title**: the meeting or appointment name from Google Calendar > **Time and duration**: start time, end time and total duration > **Calendar source**: the Google calendar the event comes from > **Event details**: description and location when available > **Attendee information**: meeting participants (when shared) ## Working with calendar events in Zaphiri ### During Daily Planning Use calendar events to plan your day: > [!tip] Planning with calendar events > **Morning review**: check your meetings before you plan tasks > **Room to switch**: leave time between meetings and focused work > **Energy match**: plan demanding tasks away from meeting-heavy periods > **Realistic goals**: set daily task goals that allow for meeting time ### Calendar event details Select any calendar event in Zaphiri to see: - **Full event description**: the complete details from Google Calendar - **Meeting location**: physical or virtual meeting details - **Attendee list**: who else is invited - **Calendar source**: the Google calendar that holds the event ## Calendar selection and management ### Managing auto-import Control which meetings appear in your Zaphiri plan on their own: > [!success] Auto-import controls > **Calendar level**: turn auto-import on or off for all events from a specific calendar > **Event level**: stop auto-import for specific recurring events while keeping others > **Future only**: stopping auto-import affects only today and future events, not past ones ### How to manage auto-import 1. **Open Integration Settings**: go to Settings → Integrations → Google 2. **Select calendars**: choose which Google calendars to connect 3. **Turn on auto-import**: toggle auto-import for whole calendars 4. **Manage recurring events**: select the auto-import icon on any recurring event to: - End auto-import after this instance - Delete all future auto-imported instances 5. **Stop all auto-imports**: clear every calendar selection to turn off auto-import completely > [!tip] Instant sync > Changes to auto-import rules in [[Integration Settings]] show up straight away in your [[Weekly Overview|Week View]], with no manual refresh. > [!note] Auto-import behaviour > When you stop auto-importing an event, Zaphiri adds it to an exclusion list so it isn't imported again. The change takes effect straight away for today and all future occurrences. ## Privacy and security - **Read-only access**: Zaphiri cannot change your Google Calendar - **Minimal permissions**: only calendar event information is accessed - **Secure connection**: all data travels over an encrypted connection - **You stay in control**: disconnect at any time in Integration Settings ## Troubleshooting the Google integration ### Connection issues > [!warning] Common connection problems > **Calendar events not showing**: check the connection status in Integration Settings > **Outdated events**: check that Google Calendar sync is working > **Missing calendars**: make sure you've selected the right calendars to display > **Permission errors**: reconnect and grant calendar permissions again ### Display problems > [!warning] Calendar display issues > **Events in the wrong time zone**: check the time zone settings in both Google and Zaphiri > **Overlapping events**: check that the calendar has the correct event times > **Missing event details**: check Google Calendar permissions and event privacy settings > **Sync delays**: allow a little time for changes to reach Zaphiri from Google ### Reconnecting Google Calendar If the integration stops working: > [!tip] Reconnection steps > **1. Disconnect**: remove the current Google connection in Integration Settings > **2. Clear cache**: refresh Zaphiri to clear any cached data > **3. Reconnect**: set up the Google integration again > **4. Reselect calendars**: choose which calendars to display > **5. Test the integration**: check that events appear correctly in Zaphiri With Google Calendar connected, Zaphiri shows the time you've already committed beside your tasks, so your daily plan is realistic. --- **Next:** Set up calendar viewing with [[Microsoft Integration]].