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


---

# 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, and the optional `goal` query parameter:

```
GET https://guide.ellieplanner.com/features/the-timebox/apple-calendar-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.