Saltar al contenido
Todas las herramientas

m365_create_event

Microsoft 365 · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Crea un evento en el calendario de Microsoft 365/Outlook conectado. Si se indica `attendees`, Microsoft 365 envía por correo una invitación de reunión a cada uno de ellos en cuanto se crea el evento: crear con asistentes ES enviar invitaciones, así que revise antes la lista con el usuario. Las horas se interpretan en `timezone`, que por defecto es UTC; pase la zona horaria del usuario o el evento quedará a una hora incorrecta. Usa el calendario principal salvo que `calendar` indique otro. Si se llama sin confirm, devuelve una vista previa de todos los campos y no toca nada; pase confirm=true para crearlo. Devuelve el id del evento. Para la aplicación Calendario de la Mac, use create_calendar_event en su lugar.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para m365_create_event. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "end": "2026-10-06T11:00:00",
  "start": "2026-10-06T10:00:00",
  "subject": "Planning meeting"
}

Windows

Propósito

Crea un evento en el calendario predeterminado de la cuenta de Microsoft 365 conectada con connect_m365_account, a través de Microsoft Graph (para la aplicación de escritorio de Outlook use outlook_calendar_create_event). Sin confirm=true no se crea ni se envía nada: la llamada devuelve una vista previa de todos los campos, sin contactar con Microsoft 365, así que muéstrela al usuario. Con confirm=true se crea el evento, cada dirección de `attendees` se agrega como asistente obligatorio y Microsoft 365 envía a cada uno una invitación de reunión. `start` y `end` se interpretan en `timezone`, que por defecto es UTC, no la zona local del usuario: páselo. Nada comprueba si ya existe un evento, así que confirmar dos veces crea dos. La respuesta incluye el ID del evento, que m365_delete_event admite para eliminarlo; este servidor no tiene ninguna herramienta para editarlo.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para m365_create_event. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "end": "2026-10-06T11:00:00",
  "start": "2026-10-06T10:00:00",
  "subject": "Planning meeting"
}