> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kalender-einrichten-und-verwalten/icloud-kalender-verbinden.md).

# iCloud-Kalender verbinden

## Wofür iCloud geeignet ist

Die iCloud-Verbindung hilft dir, deine Verfügbarkeit zu schützen. Termine aus dem ausgewählten iCloud-Kalender können als belegte Zeit berücksichtigt werden, sodass dort keine weitere Buchung angeboten wird.

> **Beispiel:** Ben hält private Arzttermine und berufliche Abwesenheiten in iCloud fest. Er fügt diesen Kalender als Konfliktkalender hinzu. Ein als **beschäftigt** markierter Eintrag am Mittwochvormittag sperrt dann diesen Zeitraum in seinem Buchungslink.

Nutze iCloud vor allem als verlässliche Prüfung auf belegte Zeiten. Ereignisse aus iCloud werden in der Standardsynchronisation als blockierte Zeit behandelt. Aus den Gästen eines iCloud-Termins werden dabei keine Kontakte erstellt und es starten keine automatischen Abläufe. Ein intern angelegter Block wird nicht automatisch zurück in iCloud geschrieben.

## Was du vorab brauchst

* Zugriff auf **Kalender > Kalendereinstellungen** im ONE LOOP Standort.
* Das Apple-Konto des gewünschten iCloud-Kalenders.
* Aktivierte Zwei-Faktor-Authentifizierung für dieses Apple-Konto.
* Ein **app-spezifisches Passwort** von Apple. Das ist ein separates Kennwort und nicht dein normales Apple-Konto-Passwort.
* Zugriff auf den Kalender, dessen Belegungen geprüft werden sollen.

Ein öffentlich abonnierter iCloud-Kalender, der nur über eine Internetadresse eingebunden wird, kann nicht als Verbindung verwendet werden.

## App-spezifisches Passwort bei Apple erstellen

1. Melde dich im Sicherheitsbereich deines Apple-Kontos an.
2. Prüfe, ob die Zwei-Faktor-Authentifizierung aktiv ist.
3. Öffne den Bereich **App-spezifische Passwörter**.
4. Wähle **App-spezifisches Passwort erstellen**.
5. Vergib eine eindeutige Bezeichnung, zum Beispiel **Kalenderverbindung**.
6. Erstelle das Passwort.
7. Kopiere es sofort und bewahre es vertraulich auf. Apple zeigt dieses Passwort nur beim Erstellen vollständig an.

Dieses Passwort ist ausschließlich für diese Verbindung gedacht. Gib es nicht an andere Personen weiter und verwende es nicht als allgemeines Passwort.

## iCloud in ONE LOOP verbinden

1. Öffne **Kalender > Kalendereinstellungen > Verbindungen**.
2. Klicke auf **Neu hinzufügen** beziehungsweise **+ Add New**.
3. Wähle bei **iCloud-Kalender** die Schaltfläche **Verbinden**.
4. Trage im Dialog dein Apple-Konto ein.
5. Füge darunter das app-spezifische Passwort ein.
6. Klicke auf **Verbinden**.
7. Prüfe, ob die iCloud-Verbindung anschließend in der Liste erscheint.

In der Kalenderkonfiguration wählst du danach die Kalenderrolle aus:

| Rolle                    | Wann du sie verwendest                                               | Wirkung                                                                                                                                                           |
| ------------------------ | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Konfliktkalender**     | Du möchtest vor allem private oder bereits belegte Zeiten schützen.  | Als **beschäftigt** markierte iCloud-Termine blockieren die entsprechenden Buchungszeiten. Als **frei** markierte Termine blockieren sie nicht.                   |
| **Verknüpfter Kalender** | Du möchtest einen Kalender gezielt für den Terminabgleich verwenden. | Der Kalender wird als Ziel für den Abgleich ausgewählt. Dafür sind Schreibrechte erforderlich. Prüfe die tatsächliche Wirkung anschließend mit einer Testbuchung. |

Wähle nur die Kalender aus, die deine Verfügbarkeit wirklich beeinflussen sollen. Für viele Einsteiger ist ein beruflicher Kalender als Ziel und ein privater Kalender als Konfliktkalender die übersichtlichste Lösung.

## Test vor dem Teilen eines Buchungslinks

1. Lege in iCloud einen kurzen Termin während einer sonst freien Buchungszeit an und markiere ihn als **beschäftigt**.
2. Öffne deinen Buchungslink in einem privaten Browserfenster.
3. Prüfe, ob dieser Zeitraum nicht mehr auswählbar ist.
4. Buche einen freien Testtermin.
5. Kontrolliere im ONE LOOP Kalender den neu angelegten Termin.
6. Wenn du einen verknüpften Kalender ausgewählt hast, prüfe zusätzlich dort, ob die erwartete Übernahme erfolgt.

Erst wenn diese Schritte stimmen, solltest du den Buchungslink weitergeben. So erkennst du falsch ausgewählte Kalender oder fehlende Rechte, bevor eine echte Buchung betroffen ist.

## Grenzen und häufige Probleme

| Beobachtung                                                        | Bedeutung oder Lösung                                                                                                                        |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Ein iCloud-Termin blockiert nicht                                  | Prüfe, ob der richtige Kalender als Konfliktkalender gewählt wurde und ob der Termin als **beschäftigt** markiert ist.                       |
| Die Anmeldung schlägt fehl                                         | Prüfe Apple-Konto, Zwei-Faktor-Authentifizierung und das app-spezifische Passwort. Das normale Apple-Konto-Passwort funktioniert hier nicht. |
| Die Verbindung war aktiv und funktioniert später nicht mehr        | Stelle die Verbindung erneut her, wenn Apple-Zugriff, Passwort oder Sicherheitsoptionen geändert wurden.                                     |
| Ein iCloud-Termin soll Kontakte oder automatische Abläufe auslösen | Das wird in der Standardsynchronisation nicht ausgelöst. Plane solche Abläufe nur mit Terminen, die innerhalb von ONE LOOP entstehen.        |
| Ein neuer interner Block soll sofort in iCloud erscheinen          | Verlasse dich nicht darauf. Prüfe die Übernahme immer mit einem Testtermin im gewählten verknüpften Kalender.                                |

## Gute Praxis

* Verwende einen neutral benannten beruflichen Kalender für echte Buchungen.
* Füge private Kalender nur als Konfliktkalender hinzu.
* Kontrolliere die Zeitzone beider Kalender.
* Wiederhole nach Änderungen am Apple-Konto einen kurzen Test.
* Entferne eine Verbindung, die du nicht mehr benötigst, statt sie unbeaufsichtigt bestehen zu lassen.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kalender-einrichten-und-verwalten/icloud-kalender-verbinden.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.