Tutti gli strumenti

create_calendar_event

Calendario · macOS

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Crea un evento nell'app Calendario del Mac (Calendar.app). Richiede il titolo, start_date, end_date. Facoltativamente, puoi invitare i partecipanti tramite e-mail (solo calendari CalDAV/Exchange) o renderlo un evento ricorrente con "recurrence" (giornaliero/settimanale/mensile/annuale). Per Microsoft 365 utilizzare invece m365_create_event. Elementi tecnici invariati: weekly, monthly.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — macOS
{
  "properties": {
    "attendees": {
      "description": "List of email addresses to invite (optional, CalDAV/Exchange only)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "calendar": {
      "description": "Calendar name to match (optional, alternative to calendar_id)",
      "type": "string"
    },
    "calendar_id": {
      "description": "Calendar UUID from list_calendar_names (optional, defaults to default calendar)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to create the event",
      "type": "boolean"
    },
    "end_date": {
      "description": "ISO 8601 date or datetime, same timezone rules as start_date. For an all-day event pass a bare date (end is inclusive: same date as start = a one-day all-day event; a later date spans through that day).",
      "type": "string"
    },
    "location": {
      "description": "Location (optional)",
      "type": "string"
    },
    "notes": {
      "description": "Event notes (optional)",
      "type": "string"
    },
    "recurrence": {
      "description": "Make it a repeating event: 'daily', 'weekly', 'monthly', or 'yearly' (optional; omit for a one-time event).",
      "type": "string"
    },
    "recurrence_count": {
      "description": "Total number of occurrences (optional). Mutually exclusive with recurrence_until; if neither is given the event repeats indefinitely.",
      "type": "integer"
    },
    "recurrence_interval": {
      "description": "Repeat every N periods (optional, default 1 — e.g. recurrence='weekly' + recurrence_interval=2 = every 2 weeks).",
      "type": "integer"
    },
    "recurrence_until": {
      "description": "ISO 8601 date the repetition stops on (optional; takes precedence over recurrence_count).",
      "type": "string"
    },
    "start_date": {
      "description": "ISO 8601 date or datetime. With a time (2026-06-27T09:00:00) the event is timed; a time with NO timezone is read in the Mac's LOCAL zone, append Z or an offset (2026-06-27T09:00:00Z, or +02:00) to pin it to UTC/another zone. Pass a bare DATE (YYYY-MM-DD) for BOTH start_date and end_date to create an ALL-DAY event.",
      "type": "string"
    },
    "title": {
      "description": "Event title",
      "type": "string"
    }
  },
  "required": [
    "title",
    "start_date",
    "end_date"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per create_calendar_event. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "confirm": false,
  "end_date": "2026-10-06T11:00:00",
  "start_date": "2026-10-06T10:00:00",
  "title": "Planning meeting"
}