# Google Calendar Two-Way Sync

Easily add, edit, and delete events from your private Google Calendar directly in Obsidian using **OAuth 2.0 authentication**.

!!! success "Verified Integration"
    Full Calendar Remastered is an officially verified Google integration. You can now connect your accounts directly without creating your own Google Cloud credentials.

Calendars automatically refresh every **5 minutes**. To manually refresh calendars, run the [FCR Command](../features/nlp.md): `refresh calendars` or use the command `Full Calendar: Revalidate remote calendars`.

!!! tip "Power Up with Categories"
    Google Calendar events fully support [Advanced Categories](../events/categories.md). Use a title like `Personal - Doctor` to automatically apply your "Personal" color and styling.


---

## Quick Start: Connecting Your Account

1.  Open [Full Calendar Settings](../settings/index.md) → [Calendar Sources](../settings/sources.md).
2.  Click **Add Source** and select **Google Calendar**.
3.  Click **Login with Google**. This will open your default browser.
4.  Follow the standard Google sign-in flow.
5.  Once authorized, select the specific calendars you want to display in Obsidian.

---


---

## Advanced: Custom Google Cloud Credentials (Optional)

If you prefer to maintain your own OAuth Client ID and Secret for privacy or development reasons, you can enable **Custom Credentials** in the [API and Security Settings](../settings/api.md).

### Step-by-Step Setup Guide

#### 1️⃣ Create a Project in Google Cloud Console
![Google Console Project Setup](../../assets/calendars/google-setup/1.google-console-project.gif)

#### 2️⃣ Configure OAuth Consent Screen
![Setup Project Config](../../assets/calendars/google-setup/2.setup-config-for-oauth.gif)

#### 3️⃣ Enable the Google Calendar API
![Enable Calendar API](../../assets/calendars/google-setup/3.calender-api-enable.gif)

#### 4️⃣ Add Your Google Account as a Test User
![Add Test User](../../assets/calendars/google-setup/4.add-test-user.gif)

#### 5️⃣ Create OAuth Credentials for a Desktop Client
![Create OAuth ID](../../assets/calendars/google-setup/5.OuAuth-ID.gif)

#### 6️⃣ Add Your Client ID and Secret to the Plugin
![Add ID to Plugin](../../assets/calendars/google-setup/6.Add-ID-to-Obsidian.gif)

---

## Feature Notes

- **Two-Way Sync**: Changes made in Obsidian (create, edit, delete) are instantly reflected in Google Calendar.
- **Google Tasks Coexistence**: Connecting [Google Tasks](gtasks.md) under the same Google account is fully safe. Each provider requests only its own OAuth permissions, and the plugin automatically preserves both providers' access — connecting Tasks never removes your Calendar authorization, and vice versa.
- **Video Conferencing**: Automatically extracts meeting links (e.g., Google Meet, Zoom) from `conferenceData` and injects them into the event's location or description (rendered as clickable hyperlinks in the [Event Details modal](../events/manage.md#video-conference--linkification-support)). See the [Video Conference & Linkification Guide](../events/manage.md#video-conference--linkification-support).
- **Recurring Events**: Supports exceptions and cancellations. Deleting a single instance in a series creates a proper "cancelled" instance in the Google API.
- **Timezone Management**: Events are normalized to your [Display Timezone](../settings/fc_config.md) while respecting the original source timezone for recurrence rules.
- **Event Linked Notes**: Keep rich local meeting notes or agendas connected directly to remote Google Calendar events with automated template population. Name-based mode reuses the exact sanitized title file; deadline-based mode can keep recurring occurrences separate. See the [Event Linked Notes Guide](../features/event-linked-notes.md) for details.
- **Mobile Support**: On iOS/Android, the login flow opens a blank tab first to bypass popup blockers. Ensure popups are allowed for Obsidian.

## Troubleshooting & Manual Authorization

*   **Manual Authorization:** See the [Central Troubleshooting Guide](../guides/troubleshooting.md#google-calendar-authentication-manual-flow) for help with OAuth redirects and manual copy-paste login.
*   **Android and iOS Authentication Workaround:** For step-by-step instructions on authenticating Google Calendar/Tasks on mobile devices using vault synchronization, see [Mobile Authentication Workaround](../guides/troubleshooting.md#mobile-authentication-workaround).

---

[CalDAV Two-Way Sync](caldav.md) · [iCal / ICS Support](ics.md) · [Back to Index](index.md)