> For the complete documentation index, see [llms.txt](https://monthly-calender-widgets.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://monthly-calender-widgets.gitbook.io/docs/getting-started/connect-calendars.md). # Connect calendars Monthly Calendar Widgets supports **two calendar sources** and recommends using both for the most complete experience. ## Calendar (iOS) **Best for:** Automatic updates with zero maintenance. iOS Calendar integration uses Apple's EventKit framework to access calendars configured on your device. This includes calendars from iCloud plus third-party accounts added in iOS Calendar (Google added in iOS, Outlook, Exchange, Yahoo, CalDAV, and subscribed calendars). ### What you can do * View events from all your on-device calendars in widgets and in-app. * Choose exactly which calendars to show (toggle individual calendars on/off). * Create and edit events directly inside the app. * Events update automatically when your calendars change -- no manual sync needed. ### How to connect 1. Open the app and go to **Settings** (Profile tab). 2. Under **Data Sources**, tap **Calendar (iOS)**. 3. Allow calendar access if prompted. 4. Toggle on the calendars you want to display. ### Important notes * If you don't see all your calendars, make sure they are enabled in the built-in iOS Calendar app as well. * Subscribed and shared calendars may be read-only (you can view events but not edit them). * Calendar colors come from iOS and may differ from the colors shown in Google Calendar's web interface. ## Google Calendar (optional OAuth sync) **Best for:** Exact Google event colors and offline access to a large event window. Google Calendar sync connects directly to the Google Calendar API using OAuth authentication. This is the only direct, separate calendar API integration in the app, and it gives you accurate event colors that match what you see on calendar.google.com. ### What you can do * View events with their **exact Google Calendar colors** (not the approximated iOS colors). * Access all your Google calendars in one place. * Download a large event window -- **3 years of data** (2 years past + 1 year future) in a single sync. * Use your calendar **offline** after syncing. Events are stored locally on your device. * See Google event colors rendered in Home Screen widgets. ### How to connect 1. Open the app and go to **Settings** (Profile tab). 2. Under **Data Sources**, tap **Google Calendar**. 3. Tap **Connect Google Account**. 4. A Google sign-in page will open in your browser. Sign in and allow calendar access. 5. Return to the app and tap **Sync Now** to fetch your events. ### Sync limits Free accounts get **2 Google syncs per week**; **Pro is unlimited**. Notes: * A single sync downloads about 3 years of events and caches them on your device, so you rarely need to sync more than once or twice a week on the free tier. * Sync when you've added, edited, or deleted events in Google Calendar and want the changes reflected in the app. * Pro removes the limit so your widgets can refresh as often as you like. ### Conflict behavior If you edit a Google Calendar event inside the app (locally), and then sync with Google, the app needs to decide which version to keep. You can configure this in **Settings** > **Optional Settings** > **Google Sync Conflict**: * **Ask every time** -- The app will prompt you to choose during sync. * **Keep my edits** -- Local changes are preserved; Google data does not overwrite them. * **Restore from Google** -- Google data takes priority; local changes are discarded. ### Disconnecting Google To disconnect your Google account: 1. Go to **Settings** > **Data Sources** > **Google Calendar**. 2. Tap **Disconnect**. 3. This removes stored OAuth tokens and clears cached Google events.## Using both sources together<<<<<<< Updated upstream We recommend enabling both iOS Calendar and Google Calendar:- **iOS Calendar** provides automatic, always-current event data without manual syncing. <<<<<<< HEAD * Outlook, Exchange, Yahoo, and other non-Google providers are accessed through iOS Calendar when those accounts are added in iOS. * **Google Calendar** provides exact color coding and a deep offline archive.The app is designed to avoid duplicate event display when both sources are active. Events from both sources are merged intelligently in widgets and in-app views. ======= * **Google Calendar** provides exact color coding and a deep offline archive.The app is designed to avoid duplicate event display when both sources are active. Events from both sources are merged intelligently in widgets and in-app views. > > > > > > > e71208b79c5b95a1b709d0ac33eebc38a42789e0 ======= We recommend enabling both iOS Calendar and Google Calendar:- **iOS Calendar** provides automatic, always-current event data without manual syncing. * **Google Calendar** provides exact color coding and a deep offline archive.The app is designed to avoid duplicate event display when both sources are active. Events from both sources are merged intelligently in widgets and in-app views. > > > > > > > Stashed changes --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://monthly-calender-widgets.gitbook.io/docs/getting-started/connect-calendars.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.