Skip to content

Google Calendar Two-Way Sync

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

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: refresh calendars or use the command Full Calendar: Revalidate remote calendars.

Power Up with Categories

Google Calendar events fully support Advanced Categories. Use a title like Personal - Doctor to automatically apply your "Personal" color and styling.

Quick Start: Connecting Your Account

  1. Open Full Calendar Settings → Calendar Sources.
  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.

Step-by-Step Setup Guide

1️⃣ Create a Project in Google Cloud Console

Google Console Project Setup

Setup Project Config

3️⃣ Enable the Google Calendar API

Enable Calendar API

4️⃣ Add Your Google Account as a Test User

Add Test User

5️⃣ Create OAuth Credentials for a Desktop Client

Create OAuth ID

6️⃣ Add Your Client ID and Secret to the Plugin

Add ID to Plugin

Feature Notes

  • Two-Way Sync: Changes made in Obsidian (create, edit, delete) are instantly reflected in Google Calendar.
  • Google Tasks Coexistence: Connecting Google Tasks 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). See the Video Conference & Linkification Guide.
  • Display Mode Persistence: Custom display modes (background, inverse-background, list-item, block) are persisted to Google Calendar using private extended properties (extendedProperties.private['ofc-display']), preventing sync operations from reverting background styling back to standard foreground events.
  • Non-Destructive Sync via HTTP PATCH: Calendar updates issue HTTP PATCH requests rather than replacing entire resources via PUT. This safeguards attendee lists, Google Meet conference details, event colors (colorId), and third-party calendar metadata from accidental deletion.
  • Non-Destructive Reminder Synchronization: Omitting reminders preserves Google Calendar's default calendar notifications. When reminders are configured, both popup and email alarms are captured and synchronized, while untouched reminders pass through intact without collapsing multiple reminders into a single value.
  • Full RFC 5545 Recurrence Generator: Backed by a dedicated recurrence rule engine (recurrenceRule.ts) supporting daily intervals, weekly, monthly, and yearly recurring series, all-day recurring events, and isolated single-instance overrides.
  • Recurring Events & Cancellations: Supports single-instance exceptions and cancellations. Deleting a single instance in a series creates a proper "cancelled" instance in the Google API without affecting the remainder of the series.
  • Timezone Management: Events are normalized to your Display Timezone 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 for details.
  • Mobile Support: On iOS/Android, the login flow opens a browser tab to perform OAuth. If iOS Safari or Obsidian's environment blocks the popup window, Full Calendar automatically detects this and presents an interactive copy-paste authorization modal so you can complete sign-in without getting stranded.

Troubleshooting & Manual Authorization

  • Manual Authorization: See the Central Troubleshooting Guide for help with OAuth redirects, popup blocking fallbacks, 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.

CalDAV Two-Way Sync · iCal / ICS Support · Back to Index