create_event

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

Verhalten und Grenzen

Erstellt einen Einzeltermin ohne Gäste in einem beschreibbaren Google-, Microsoft- oder CalDAV-Kalender. Begrenzte Wochenserien sind nur für Google und Microsoft möglich; CalDAV-Serien werden in der Kalender-App angelegt. Für eine Serie übergib recurrence mit frequency=weekly, count von 2 bis 104 Vorkommen einschließlich des ersten und optional interval in Wochen, standardmäßig 1. Das letzte Vorkommen muss innerhalb von 104 Wochen liegen. Die Serie wiederholt sich am Wochentag und zur lokalen Uhrzeit von start in timeZone. Bei Serien müssen start und end auf demselben lokalen Tag liegen und dürfen eine Zeitumstellung weder einschließen noch darin liegen. Bestätige Wiederholung und Gesamtanzahl vor der Anlage mit dem Nutzer. requestId bezeichnet die gesamte Serie und bleibt bei Wiederholungen unverändert. start und end benötigen einen UTC-Offset; timeZone muss eine IANA-Zeitzone sein. Das Werkzeug sendet keine Einladungen. Serien und ihre Vorkommen können per MCP noch nicht geändert oder gelöscht werden; nutze dafür den Anbieterkalender.

Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

calendar:read, calendar:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "calendarId": {
      "type": "string",
      "minLength": 1
    },
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "recurrence": {
      "type": "object",
      "properties": {
        "frequency": {
          "type": "string",
          "const": "weekly"
        },
        "interval": {
          "type": "integer",
          "minimum": 1,
          "maximum": 104
        },
        "count": {
          "type": "integer",
          "minimum": 2,
          "maximum": 104
        }
      },
      "required": [
        "frequency",
        "count"
      ],
      "additionalProperties": false
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "description": {
      "type": "string",
      "maxLength": 10000
    },
    "location": {
      "type": "string",
      "maxLength": 1000
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "freeBusyStatus": {
      "type": "string",
      "enum": [
        "free",
        "busy"
      ]
    }
  },
  "required": [
    "calendarId",
    "requestId",
    "title",
    "start",
    "end",
    "timeZone"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "eventId": {
      "type": "string"
    },
    "idempotentReplay": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "idempotencyStatus": {
      "type": "string",
      "enum": [
        "created",
        "replayed",
        "provider_managed"
      ]
    }
  },
  "required": [
    "ok",
    "eventId",
    "idempotentReplay",
    "idempotencyStatus"
  ],
  "additionalProperties": false
}

Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den Kalenderzustand.

Fehlerbehandlung