# 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/)!


---

# Agent Instructions: 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://guide.ellieplanner.com/features/the-timebox/apple-calendar-integration.md?ask=<question>
```

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.