Todas las herramientas

create_calendar_event

Calendario · macOS

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 la aplicación Calendario de Mac (Calendar.app). Requiere `title`, `start_date` y `end_date`. También puede invitar asistentes (`attendees`) por correo electrónico, solo en calendarios CalDAV o Exchange, o crear un evento repetitivo mediante `recurrence` (daily/weekly/monthly/yearly). Para Microsoft 365, usa m365_create_event.

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": {
    "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"
}

Ejemplo documental

Ejemplo de documentación para create_calendar_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_date": "2026-10-06T11:00:00",
  "start_date": "2026-10-06T10:00:00",
  "title": "Planning meeting"
}