Vai al contenuto
Tutti gli strumenti

m365_create_event

Microsoft 365 · macOS · Windows

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 nel calendario Microsoft 365 / Outlook collegato. Se `attendees` è impostato, Microsoft 365 invia a ciascuno un invito alla riunione non appena l'evento viene creato: creare con attendees significa inviare gli inviti, quindi controlla prima l'elenco con l'utente. Gli orari vengono interpretati in `timezone`, che per impostazione predefinita è UTC (non l'ora di questo Mac, a differenza di create_calendar_event): passa il fuso orario dell'utente, altrimenti l'evento finisce all'ora sbagliata; l'anteprima segnala quando non è stato indicato alcun fuso orario. Usa il calendario principale, a meno che `calendar` non ne indichi un altro. Chiamato senza confirm restituisce un'anteprima di ogni campo e non tocca nulla; passa confirm=true per creare. Restituisce l'id dell'evento. Per l'app Calendario del Mac usa invece create_calendar_event.

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": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "attendees": {
      "description": "Comma-separated email addresses to invite (optional)",
      "type": "string"
    },
    "body": {
      "description": "Event description (optional)",
      "type": "string"
    },
    "calendar": {
      "description": "Calendar name to create the event in — partial, case-insensitive match (optional). Omit to use the primary calendar.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to create the event",
      "type": "boolean"
    },
    "end": {
      "description": "End time in ISO 8601, e.g. '2026-05-20T11:00:00'",
      "type": "string"
    },
    "location": {
      "description": "Location (optional)",
      "type": "string"
    },
    "start": {
      "description": "Start time in ISO 8601, e.g. '2026-05-20T10:00:00'",
      "type": "string"
    },
    "subject": {
      "description": "Event title",
      "type": "string"
    },
    "timezone": {
      "description": "IANA timezone, e.g. 'America/New_York' (default: UTC)",
      "type": "string"
    }
  },
  "required": [
    "subject",
    "start",
    "end"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per m365_create_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": "2026-10-06T11:00:00",
  "start": "2026-10-06T10:00:00",
  "subject": "Planning meeting"
}

Windows

Scopo

Crea un evento nel calendario predefinito dell'account Microsoft 365 collegato con connect_m365_account, tramite Microsoft Graph (per l'app desktop Outlook usa outlook_calendar_create_event). Senza confirm=true non viene creato né inviato nulla: la chiamata restituisce un'anteprima di ogni campo, senza contattare Microsoft 365, quindi mostrala all'utente. Con confirm=true l'evento viene creato, ogni indirizzo in `attendees` viene aggiunto come partecipante obbligatorio e Microsoft 365 invia a ciascuno un invito alla riunione. `start` e `end` vengono letti in `timezone`, che per impostazione predefinita è UTC, non il fuso locale dell'utente: passalo. Nulla controlla se esiste già un evento, quindi confermare due volte ne crea due. La risposta contiene l'ID dell'evento, che m365_delete_event accetta per rimuoverlo; questo server non ha uno strumento per modificarne uno.

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 — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "attendees": {
      "description": "Comma-separated email addresses to invite (optional)",
      "type": "string"
    },
    "body": {
      "description": "Event description (optional)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to create the event. Without it the call returns a preview and creates nothing.",
      "type": "boolean"
    },
    "end": {
      "description": "End time ISO 8601, e.g. '2026-05-20T11:00:00'",
      "type": "string"
    },
    "location": {
      "description": "Location (optional)",
      "type": "string"
    },
    "start": {
      "description": "Start time ISO 8601, e.g. '2026-05-20T10:00:00'",
      "type": "string"
    },
    "subject": {
      "description": "Event title",
      "type": "string"
    },
    "timezone": {
      "description": "IANA timezone, e.g. 'America/New_York' (default: UTC)",
      "type": "string"
    }
  },
  "required": [
    "subject",
    "start",
    "end"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per m365_create_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": "2026-10-06T11:00:00",
  "start": "2026-10-06T10:00:00",
  "subject": "Planning meeting"
}