> 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

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="/files/gOBRqKzl4KYVQx89GlFK" 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="/files/yrl98KhFzt4nyCvFAqS6" 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="/files/rPhd6g0jcnrRNTGInBsH" 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/)!
