feat(calendar): timezone argument for events/tasks (IANA, default Europe/Berlin) for travel/foreign timezones

This commit is contained in:
Stefan Lohmaier committed 2026-10-01 09:29:31 +02:00
1 parent a73dbe8fdc
commit 5131f77a5c
4 files changed
+83 -21

No files matched your search

+48 -20
View File
@@ -27,11 +27,22 @@ CAL_PATHS = _cfg['calendar_paths'] # Baikal-Basen (aktiv)
BERLIN = pytz.timezone('Europe/Berlin')
def _local(dt):
"""Naive -> Europe/Berlin lokalisieren; aware -> nach Europe/Berlin konvertieren."""
def _local(dt, z=None):
"""Naive -> in Zone z lokalisieren; aware -> nach z konvertieren (Default Europe/Berlin)."""
z = z or BERLIN
if dt.tzinfo is None:
return BERLIN.localize(dt)
return dt.astimezone(BERLIN)
return z.localize(dt)
return dt.astimezone(z)
def _zone(tz):
"""IANA-Zeitzone aufloesen. Leer/None -> Europe/Berlin. Ungueltig -> None."""
if not tz:
return BERLIN
try:
return pytz.timezone(tz)
except Exception:
return None
mcp = FastMCP("Calendar", stateless_http=True,
transport_security={"enable_dns_rebinding_protection": False})
@@ -126,9 +137,15 @@ def _parse(xml, comp="VEVENT", t0=None, cap=None):
return objs
def _fmt_dt(v):
"""Datetime einheitlich in Europe/Berlin darstellen (naive = lokale Wanduhrzeit)."""
"""Datetime mit explizitem Offset darstellen. Benannte IANA-Zone (Europe/Berlin,
Asia/Hong_Kong, ...) wird beibehalten; floating (naiv) = Berlin; feste Offset-/UTC-
Werte (z.B. Importe) werden nach Berlin normalisiert."""
if isinstance(v, datetime):
return _local(v).isoformat()
if v.tzinfo is None:
return _local(v).isoformat()
if getattr(v.tzinfo, "zone", None) or getattr(v.tzinfo, "key", None):
return v.isoformat()
return v.astimezone(BERLIN).isoformat()
return v.isoformat() if hasattr(v, 'isoformat') else str(v)
@@ -297,15 +314,15 @@ TRAVEL_MODES = ("walking", "driving", "transit", "biking")
def _build_vevent_fields(ev, title, start, end, location, description, allday,
travel_minutes, travel_mode, travel_advisory, reminder_minutes):
travel_minutes, travel_mode, travel_advisory, reminder_minutes, z=None):
"""Setzt VEVENT-Felder auf ein vobject-Element (wiederverwendet von create/update)."""
ev.add("summary").value = title
if allday:
ev.add("dtstart").value = datetime.strptime(start, "%Y-%m-%d").date()
ev.add("dtend").value = datetime.strptime(end, "%Y-%m-%d").date()
else:
ev.add("dtstart").value = _local(datetime.fromisoformat(start))
ev.add("dtend").value = _local(datetime.fromisoformat(end))
ev.add("dtstart").value = _local(datetime.fromisoformat(start), z)
ev.add("dtend").value = _local(datetime.fromisoformat(end), z)
if location:
ev.add("location").value = location
geo = _geocode(location)
@@ -339,7 +356,10 @@ def _build_vevent_fields(ev, title, start, end, location, description, allday,
def _write_event(user, cals, title, start, end, location, description, allday,
travel_minutes, travel_mode, travel_advisory, reminder_minutes,
uid=None, verb="Termin erstellt"):
uid=None, verb="Termin erstellt", timezone="Europe/Berlin"):
z = _zone(timezone)
if z is None:
return f"Fehler: unbekannte Zeitzone '{timezone}' (IANA-Name, z.B. Europe/Berlin, Asia/Hong_Kong)"
cal = vobject.iCalendar()
ev = cal.add("vevent")
if uid:
@@ -349,7 +369,7 @@ def _write_event(user, cals, title, start, end, location, description, allday,
target = cals[0]["href"] + uid + ".ics"
ev.add("uid").value = uid
_build_vevent_fields(ev, title, start, end, location, description, allday,
travel_minutes, travel_mode, travel_advisory, reminder_minutes)
travel_minutes, travel_mode, travel_advisory, reminder_minutes, z)
r = httpx.put(_serve(user)[0] + target,
content=cal.serialize(), auth=_auth(user),
headers={"Content-Type": "text/calendar"}, timeout=15)
@@ -359,6 +379,7 @@ def _write_event(user, cals, title, start, end, location, description, allday,
if travel_mode: extras.append(f"Verkehrsmittel {travel_mode}")
if travel_advisory: extras.append("Reisezeit aus Route")
if reminder_minutes: extras.append(f"Erinnerung {reminder_minutes} Min. vorher")
if timezone and timezone != "Europe/Berlin": extras.append(f"Zeitzone {timezone}")
extra_str = f" ({', '.join(extras)})" if extras else ""
if r.status_code in (201, 204):
return f"{verb}: {title} am {start}{extra_str}"
@@ -371,8 +392,8 @@ def _write_event(user, cals, title, start, end, location, description, allday,
def create_event(
calendar: Annotated[str, Field(description="Calendar name, e.g. 'Stefan', 'Arbeit', 'Familie'")],
title: Annotated[str, Field(description="Event title")],
start: Annotated[str, Field(description="Start: YYYY-MM-DD for all-day, or YYYY-MM-DDTHH:MM for timed events, e.g. '2026-06-15T14:00'. Lokale Zeit Europe/Berlin; explizite Offsets/Z werden konvertiert.")],
end: Annotated[str, Field(description="End: YYYY-MM-DD for all-day, or YYYY-MM-DDTHH:MM, e.g. '2026-06-15T15:30'. Lokale Zeit Europe/Berlin.")],
start: Annotated[str, Field(description="Start: YYYY-MM-DD for all-day, or YYYY-MM-DDTHH:MM for timed events, e.g. '2026-06-15T14:00'. Lokale Zeit in der Zone aus 'timezone' (Default Europe/Berlin); explizite Offsets/Z werden in diese Zone konvertiert.")],
end: Annotated[str, Field(description="End: YYYY-MM-DD for all-day, or YYYY-MM-DDTHH:MM, e.g. '2026-06-15T15:30'. Lokale Zeit in der Zone aus 'timezone'.")],
location: Annotated[str, Field(description="Location/Ziel als Text oder POI, e.g. 'Marienplatz 1, Muenchen'. Gets geocoded for map / POI.")] = "",
description: Annotated[str, Field(description="Event description or notes")] = "",
allday: Annotated[bool, Field(description="True for all-day events (then use YYYY-MM-DD for start/end)")] = False,
@@ -380,15 +401,16 @@ def create_event(
travel_mode: Annotated[str, Field(description="Optional. Verkehrsmittel fuer die Reise: walking, driving, transit, biking. Leer lassen, wenn nicht relevant.")] = "",
travel_advisory: Annotated[bool, Field(description="True: Apple Kalender berechnet die Reise-Erinnerungszeit selbst dynamisch aus der aktuellen Route anhand des Ziels (location). Empfohlen fuer Termine mit Zieladresse.")] = False,
reminder_minutes: Annotated[int, Field(description="Reminder alert X minutes before the event (0=none, e.g. 15, 30, 60)")] = 0,
timezone: Annotated[str, Field(description="IANA-Zeitzone fuer start/end. Default 'Europe/Berlin'. Fuer Termine im Ausland die Zonen-Zeit nehmen, z.B. 'Asia/Hong_Kong' (dann start/end dort lokal, z.B. 18:00).")] = "Europe/Berlin",
) -> str:
"""Create a new calendar event. For all-day events, end date is exclusive (June 15 only → start=2026-06-15, end=2026-06-16). Timed events werden als Europe/Berlin (TZID) gespeichert. Location/Ziel wird geocoded (POI/Karte). Mit travel_advisory=true + Ziel berechnet Apple die Reise-Erinnerung dynamisch aus der Route."""
"""Create a new calendar event. For all-day events, end date is exclusive (June 15 only → start=2026-06-15, end=2026-06-16). Timed events werden mit TZID der angegebenen 'timezone' gespeichert (Default Europe/Berlin). Location/Ziel wird geocoded (POI/Karte). Mit travel_advisory=true + Ziel berechnet Apple die Reise-Erinnerung dynamisch aus der Route."""
user = get_current_user()
if not user: return "Error: not authenticated"
cals = _match_cols(_discover(user, "VEVENT"), calendar)
if not cals: return f"Kalender '{calendar}' nicht gefunden"
return _write_event(user, cals, title, start, end, location, description, allday,
travel_minutes, travel_mode, travel_advisory, reminder_minutes,
verb="Termin erstellt")
verb="Termin erstellt", timezone=timezone)
@mcp.tool()
@@ -405,6 +427,7 @@ def update_event(
travel_mode: Annotated[str, Field(description="Optional. Verkehrsmittel: walking, driving, transit, biking.")] = "",
travel_advisory: Annotated[bool, Field(description="True: Apple berechnet die Reise-Erinnerungszeit dynamisch aus der Route anhand des Ziels.")] = False,
reminder_minutes: Annotated[int, Field(description="Reminder alert X minutes before the event (0=none)")] = 0,
timezone: Annotated[str, Field(description="IANA-Zeitzone fuer start/end. Default 'Europe/Berlin'. Fuer Termine im Ausland die Zonen-Zeit nehmen, z.B. 'Asia/Hong_Kong'.")] = "Europe/Berlin",
) -> str:
"""Update an existing calendar event (full overwrite of its fields). All optional fields default to clearing the previous value."""
user = get_current_user()
@@ -413,10 +436,13 @@ def update_event(
if not cals: return f"Kalender '{calendar}' nicht gefunden"
return _write_event(user, cals, title, start, end, location, description, allday,
travel_minutes, travel_mode, travel_advisory, reminder_minutes,
uid=uid, verb="Termin aktualisiert")
uid=uid, verb="Termin aktualisiert", timezone=timezone)
def _write_task(user, lists, title, due, priority, description, uid=None, verb="Aufgabe erstellt"):
def _write_task(user, lists, title, due, priority, description, uid=None, verb="Aufgabe erstellt", timezone="Europe/Berlin"):
z = _zone(timezone)
if z is None:
return f"Fehler: unbekannte Zeitzone '{timezone}' (IANA-Name, z.B. Europe/Berlin, Asia/Hong_Kong)"
cal = vobject.iCalendar()
todo = cal.add("vtodo")
if uid:
@@ -427,7 +453,7 @@ def _write_task(user, lists, title, due, priority, description, uid=None, verb="
todo.add("uid").value = uid
todo.add("summary").value = title
todo.add("status").value = "NEEDS-ACTION"
if due: todo.add("due").value = _local(datetime.fromisoformat(due)) if "T" in due else datetime.strptime(due, "%Y-%m-%d").date()
if due: todo.add("due").value = _local(datetime.fromisoformat(due), z) if "T" in due else datetime.strptime(due, "%Y-%m-%d").date()
if priority: todo.add("priority").value = str(priority)
if description: todo.add("description").value = description
todo.add("dtstamp").value = datetime.utcnow()
@@ -446,13 +472,14 @@ def create_task(
due: Annotated[str, Field(description="Due date: YYYY-MM-DD or YYYY-MM-DDTHH:MM. Leave empty for no due date.")] = "",
priority: Annotated[int, Field(description="Priority 1-9 (1=highest, 9=lowest, 0=none)")] = 0,
description: Annotated[str, Field(description="Task notes")] = "",
timezone: Annotated[str, Field(description="IANA-Zeitzone fuer due (nur bei HH:MM). Default 'Europe/Berlin', z.B. 'Asia/Hong_Kong' im Ausland.")] = "Europe/Berlin",
) -> str:
"""Create a new task/reminder in the specified list."""
user = get_current_user()
if not user: return "Error: not authenticated"
lists = _match_cols(_discover(user, "VTODO"), task_list)
if not lists: return f"Liste '{task_list}' nicht gefunden"
return _write_task(user, lists, title, due, priority, description, verb="Aufgabe erstellt")
return _write_task(user, lists, title, due, priority, description, verb="Aufgabe erstellt", timezone=timezone)
@mcp.tool()
@@ -463,13 +490,14 @@ def update_task(
due: Annotated[str, Field(description="Due date: YYYY-MM-DD or YYYY-MM-DDTHH:MM. Leave empty for no due date.")] = "",
priority: Annotated[int, Field(description="Priority 1-9 (1=highest, 9=lowest, 0=none)")] = 0,
description: Annotated[str, Field(description="Task notes")] = "",
timezone: Annotated[str, Field(description="IANA-Zeitzone fuer due (nur bei HH:MM). Default 'Europe/Berlin'.")] = "Europe/Berlin",
) -> str:
"""Update an existing task/reminder (full overwrite of its fields) in the specified list."""
user = get_current_user()
if not user: return "Error: not authenticated"
lists = _match_cols(_discover(user, "VTODO"), task_list)
if not lists: return f"Liste '{task_list}' nicht gefunden"
return _write_task(user, lists, title, due, priority, description, uid=uid, verb="Aufgabe aktualisiert")
return _write_task(user, lists, title, due, priority, description, uid=uid, verb="Aufgabe aktualisiert", timezone=timezone)
@mcp.tool()