> For the complete documentation index, see [llms.txt](https://guide.ellieplanner.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.ellieplanner.com/features/the-timebox/apple-calendar-integration.md).

# Apple calendar integration

Ellie x Apple calendar

By default, the Ellie timebox is completely separate from any external calendars. However, for users who want to integrate their Apple calendar into Ellie there are a few options.

{% hint style="info" %}
Note that the Apple cal integration for iOS and Web/Mac require different setup processes
{% endhint %}

## Overlay Apple calendar events

You can overlay Apple calendar events directly on your timebox alongside Ellie tasks. This is useful when trying to plan your tasks around scheduled meetings/events.

<figure><img src="https://3852134662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnmZdEkTM0SErtqWxGTII%2Fuploads%2F7yKGiO7JikWn3Y2Uq8YX%2FCleanShot%202023-08-07%20at%2016.27.10%402x.png?alt=media&amp;token=e5039128-f1a0-424c-bdee-ce6622765343" alt=""><figcaption></figcaption></figure>

## How does it work?

### iOS

On iOS, you can go to: Settings -> Connected Calendars -> Manage Apple calendars and turn "Enable Apple cal events" on.

{% hint style="info" %}
The Apple calendar integration for iOS requires your Apple calendar to be connected to the Apple calendar app. This is because we pull events directly from the device
{% endhint %}

### Web

The web/desktop version of Ellie is a bit more tricky. You need to follow a few steps to enable calendars. Go to Settings -> Calendars -> Connect Apple calendar account

Apple requires an app-specific password to connect to iCloud. You can generate an app-specific password at <https://appleid.apple.com/>.

Check out our [tutorial about iCloud accounts](https://support.apple.com/en-us/HT204397) for more information

<figure><img src="https://3852134662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnmZdEkTM0SErtqWxGTII%2Fuploads%2FgGEFk7ZFEV3B5I1fUeHb%2FCleanShot%202023-08-08%20at%2013.40.52%402x.png?alt=media&amp;token=eb009e5e-c792-425f-9450-f008a1c33fda" alt=""><figcaption></figcaption></figure>

Once connected, you'll be able to view your calendars and also change their colors by clicking the "3-dot" menu on the right when you hover over the calendar.

<figure><img src="https://3852134662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnmZdEkTM0SErtqWxGTII%2Fuploads%2F9B4NoMX4clfs7m248TEP%2FCleanShot%202023-08-08%20at%2013.46.41%402x.png?alt=media&amp;token=27fa0eba-b978-4463-9a94-78dea1ed5b51" alt=""><figcaption><p>Changing Apple calendar colors within Ellie</p></figcaption></figure>

{% hint style="info" %}
The ability to change colors will only impact the Ellie calendar color and will not reflect back on your Apple calendar
{% endhint %}

### Limitations (editing/2-way sync)

You can move around and delete Apple calendar events, but you cannot edit any other info at this time.

2-way syncing similar to Google calendar (Linking Ellie tasks to Apple calendar events) is not supported at this time but could be added in the future.&#x20;

If you would like to see further functionality, you can request it on our [feedback board](https://feedback.ellieplanner.com/)!