~/blog/2026/11/ics2gcal-outlook-termine-automatis.md

ics2gcal: Outlook-Termine automatisch in den Google-Kalender

7 min
Datenfluss von Outlook über das PHP-Skript ics2gcal zum Google Kalender, darunter die Cron-Zeile

Keine Zeit? Hier die Kurzversion in 30 Sekunden.

  • ics2gcal ist ein kleines PHP-Skript, das einen veröffentlichten Outlook-Kalender (ICS-Link) in einen Google-Kalender spiegelt. Es läuft auf einfachem Webspace, ganz ohne SSH, Composer oder Google-SDK.
  • Die Anmeldung bei Google erfolgt über ein Dienstkonto, der Abgleich über unsichtbare Markierungen an den Terminen. Eine Datenbank braucht es nicht, und eigene Google-Termine bleiben unberührt.
  • Serientermine, Zeitzonen, abgesagte und private Termine aus Outlook werden berücksichtigt. Teilnehmer werden bewusst nicht übernommen, damit Google keine Einladungen verschickt.
  • Sicherheit steht im Vordergrund: nur ein öffentlicher Einstiegspunkt, geheimer Schlüssel plus Basic-Auth, Schutz vor versehentlichem Massenlöschen und ein Dry-Run-Modus.
  • Kostenlos, MIT-Lizenz, ohne Gewähr. Download als ZIP am Ende des Beitrags. Grenzen: Einweg-Sync und rund 15 Minuten Verzögerung.

Der typische Anwendungsfall sieht so aus: Ein Teil der Termine wird in Outlook gepflegt, oft auf einem Exchange-Server, der Alltag läuft aber über den Google-Kalender. Wer dann abends wissen will, ob am Donnerstag noch Zeit für etwas ist, muss zwei Kalender im Kopf zusammenführen. Praktischer wäre es, wenn die Outlook-Termine einfach dort auftauchen, wo man ohnehin nachschaut.

Genau dafür habe ich ics2gcal geschrieben, ein kleines Skript, das diesen Abgleich übernimmt.

Warum ein eigener Sync?

Outlook kann einen Kalender als ICS-Link veröffentlichen. Google wiederum kann solche Links abonnieren. Eigentlich wäre die Sache damit erledigt, und für viele ist sie das auch.

Mich hat gestört, dass Google selbst entscheidet, wann es den Feed neu lädt, oft mit Stunden Verzögerung. Dazu kommt, dass abonnierte Kalender nur lesbar sind. Ein eigener Sync, der ganz normale Google-Termine anlegt, löst beides.

Ich wollte das Ganze auf einem einfachen Shared-Webspace betreiben, ohne SSH-Zugang, nur mit PHP. Bei meinem Hoster All-Inkl lässt sich ein Cronjob nur als URL-Aufruf einrichten, ein sogenannter Web-Cron.

Daraus ergaben sich die technischen Vorgaben: PHP ab Version 8.0, nur die Bordmittel curl und openssl, kein Composer, kein Google-SDK.

Aufbau und Anmeldung bei Google

Öffentlich erreichbar ist genau eine Datei: sync.php. Alles andere liegt in einem Ordner private/, den eine .htaccess mit Require all denied für Browser komplett sperrt. Dort stecken die Konfiguration, der Schlüssel des Dienstkontos und fünf Klassen in src/:

  • Http holt per cURL Daten ab, erlaubt nur http und https, erzwingt die Prüfung des TLS-Zertifikats und begrenzt die Antwort auf 20 MB.
  • GoogleCalendarClient meldet sich bei Google an, speichert das Token zwischen und wiederholt Anfragen bei 429, 5xx oder Rate-Limit mit exponentiell wachsender Wartezeit.
  • IcsParser liest das ICS-Format nach RFC 5545. Dazu gehören gefaltete Zeilen, Parameter in Anführungszeichen und verschachtelte VALARM-Blöcke, die übersprungen werden.
  • EventMapper macht aus einem VEVENT einen Google-Termin.
  • CalendarSync vergleicht, was in der Quelle steht, mit dem, was in Google steht, und gleicht beides ab.

Anmeldung per Dienstkonto

Der übliche Weg wäre ein OAuth-Login im Browser, bei dem ich auf „Zulassen“ klicke. Ein Cronjob hat aber niemanden, der klicken könnte. Deshalb nutzt das Skript ein Dienstkonto (Service Account). Das ist eine Art technischer Benutzer mit eigener E-Mail-Adresse und einem privaten Schlüssel in einer JSON-Datei.

Das Skript baut daraus ein JWT, signiert es mit RS256 über openssl_sign und tauscht es bei https://oauth2.googleapis.com/token gegen ein Access-Token. Das gilt eine Stunde und wird zwischengespeichert. In stark verkürzter Form sieht das so aus:

$jwt = b64u(json_encode(['alg' => 'RS256', 'typ' => 'JWT'])) . '.' . b64u(json_encode([
    'iss' => $clientEmail, 'scope' => 'https://www.googleapis.com/auth/calendar.events',
    'aud' => 'https://oauth2.googleapis.com/token', 'iat' => $now, 'exp' => $now + 3600,
]));
openssl_sign($jwt, $sig, $privateKey, OPENSSL_ALGO_SHA256);

Angefordert wird nur der Scope calendar.events, also das, was zum Anlegen und Ändern von Terminen nötig ist und nicht mehr. Damit das Dienstkonto überhaupt an den Zielkalender darf, teile ich diesen mit der E-Mail-Adresse des Dienstkontos und gebe ihm das Recht „Änderungen an Terminen vornehmen“.

Der Abgleich: Zustand steckt in Google

Die Frage, die mich am längsten beschäftigt hat: Woher weiß das Skript beim nächsten Lauf, welche Termine es selbst angelegt hat? Eine Datenbank wollte ich für so ein kleines Werkzeug nicht betreiben. Die Antwort liegt in Google selbst.

Jeder Termin bekommt unsichtbare Felder in den extendedProperties.private:

  • icsSync enthält die ID des Sync-Jobs.
  • icsKey ist ein sha1 aus der UID des Termins, bei einzeln geänderten Terminen einer Serie zusätzlich mit der RECURRENCE-ID.
  • icsHash ist ein md5 über den Inhalt des Termins.

Beim Lauf fragt das Skript alle Termine ab, die icsSync=<id> tragen, und vergleicht sie mit der Quelle. Fehlt ein Schlüssel in Google, wird der Termin angelegt (POST). Stimmt der Hash nicht mehr, wird er ersetzt (PUT). Gibt es einen Schlüssel in Google, den die Quelle nicht mehr kennt, wird der Termin gelöscht (DELETE). Doppelte werden entfernt. Termine, die ich selbst in Google angelegt habe, tragen keine Markierung und werden nie angefasst.

Outlook hat seine Eigenheiten und der erste Lauf

Ein ICS-Feed aus Outlook hat seine Tücken. Diese Dinge mussten gesondert behandelt werden:

  • Zeitzonen kommen als Windows-Namen wie „W. Europe Standard Time“. Eine Tabelle übersetzt sie in IANA-Namen wie Europe/Berlin. Unbekannte landen in der eingestellten Standardzeitzone.
  • Serien übernimmt das Skript über die RRULE. Das UNTIL wird auf UTC normalisiert, weil Google dabei streng ist.
  • Einzeln verschobene Termine einer Serie (RECURRENCE-ID) werden als eigener Termin angelegt. Das ursprüngliche Vorkommen nimmt das Skript per EXDATE aus der Serie.
  • Abgesagte Termine (STATUS:CANCELLED) werden nicht übernommen.
  • Frei oder gebucht richtet sich nach TRANSP bzw. X-MICROSOFT-CDO-BUSYSTATUS.
  • Teilnehmer übernehme ich bewusst nicht. Sonst würde Google anfangen, an alle Eingeladenen Benachrichtigungen zu verschicken, und das möchte niemand.

Eine Lektion aus dem ersten Lauf

Beim ersten echten Lauf klappten 78 von 79 Terminen. Einer scheiterte mit HTTP 403. Der Übeltäter war ein in Outlook als privat markierter Termin (CLASS:PRIVATE). Das Skript setzt dann in Google visibility: private, und das erlaubt Google offenbar nur mit dem Recht „Freigabe verwalten“. Mit „Änderungen vornehmen“ kam ein 403. Die Lösung ist pragmatisch: Bei einem 403 schreibt das Skript denselben Termin noch einmal ohne Sichtbarkeit.

Außerdem tauchte ein mehrtägiger Termin mit 02:00 Uhr als Startzeit auf. Am Skript lag das nicht, der Termin war in Outlook selbst so eingetragen.

Sicherheit und Tests

Ein Skript, das per URL aufrufbar ist und einen Kalender ändern darf, sollte nicht nachlässig gebaut sein. Das habe ich umgesetzt:

  • Nur sync.php ist öffentlich, private/ ist gesperrt.
  • Der Aufruf per URL braucht einen geheimen Schlüssel mit mindestens 24 Zeichen. Er wird mit hash_equals verglichen, damit sich über Antwortzeiten nichts herauslesen lässt. Zusätzlich liegt HTTP-Basic-Auth per .htaccess davor.
  • Erlaubt ist nur GET, alles andere ergibt 405. Die Antwort trägt die Header nosniff, no-store und noindex.
  • Bei Konfigurationsfehlern erscheinen Details nur auf der Kommandozeile oder im Error-Log, nie im Browser.
  • cURL spricht nur http(s), das TLS-Zertifikat wird immer geprüft, die Antwortgröße ist begrenzt.
  • Ein Lockfile verhindert, dass zwei Cron-Läufe gleichzeitig arbeiten.

Dazu kommt der Schutz vor Datenverlust. Ist der Feed leer oder kaputt, ändert das Skript nichts (Einstellung min_events). Würde es mehr als die Hälfte der Termine löschen, setzt es das Löschen aus (max_delete_ratio). Und mit dem Dry-Run-Modus lässt sich alles erst einmal trocken durchspielen. Die JSON-Datei des Dienstkontos ist übrigens wie ein Passwort zu behandeln.

Wie ich getestet habe

Getestet habe ich in einer lokalen Testumgebung. Dabei habe ich den Code Stück für Stück optimiert, bis die finale Fassung mit den fünf Klassen stand. Für den Import habe ich einen separaten Google-Kalender verwendet. Sollte beim Anlegen oder Löschen etwas schiefgehen, trifft es nur diesen Testkalender und nicht mein Hauptkonto. Erst die fertige Fassung kam auf den Webspace. Dort lief zuerst ein Dry-Run, danach der erste echte Lauf. Ein zweiter Durchlauf meldete null Änderungen, und genau so soll es sein: Die Hashes der Termine waren identisch, es gab also nichts zu tun.

Einrichtung in Kurzform

  1. In Outlook den Kalender veröffentlichen und den ICS-Link kopieren.
  2. In der Google Cloud ein Projekt anlegen und die Calendar API aktivieren.
  3. Ein Dienstkonto samt JSON-Schlüssel erstellen.
  4. Den Zielkalender mit der E-Mail-Adresse des Dienstkontos teilen.
  5. config.sample.php nach config.php kopieren und anpassen.
  6. Alles hochladen und einen Dry-Run starten.
  7. Den Web-Cron einrichten, bei mir alle 15 Minuten.

Die Konfiguration ist überschaubar. Ein Job sieht so aus (mit Platzhaltern):

'syncs' => [[
    'id'          => 'outlook-kalender',
    'ics_url'     => 'https://outlook.office365.com/owa/calendar/…/calendar.ics',
    'calendar_id' => 'xxxxxxxx@group.calendar.google.com',
    'reminders'   => true,
]],

Grenzen und Download

Ehrlich gesagt ist das kein vollwertiger Kalenderabgleich, sondern ein Einweg-Sync. Was ich in Google an einem übernommenen Termin ändere, geht bei der nächsten Änderung in Outlook verloren. Dazu kommen die 15 Minuten Verzögerung, die der Takt des Cronjobs vorgibt. Und der Feed liefert nur das, was Outlook überhaupt veröffentlicht. Für den gedachten Zweck reicht das: Gelesen wird in Google, gepflegt wird weiter in Outlook.

ics2gcal ist kostenlos und steht unter der MIT-Lizenz, die Nutzung erfolgt ohne Gewähr. Das ZIP enthält alle Dateien: ics2gcal.zip herunterladen

Eine kürzere Beschreibung ohne Technik gibt es auf der Projektseite.

Beitragsbild: eigene Grafik mit den Logos von Microsoft Outlook, PHP und Google Kalender (Markenzeichen der jeweiligen Inhaber, Quelle: Wikimedia Commons).

$ whoami
Christian Ackermann

Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.