Todas as ferramentas

create_calendar_event

Calendário · macOS

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Cria um evento no aplicativo Calendário do Mac (Calendar. app). Requer título, start_date, end_date. Opcionalmente, convide os participantes por e-mail (somente calendários CalDAV/Exchange) ou torne-o um evento repetido com `recurrence` (diário/semanal/mensal/anual) (weekly, monthly). Para o Microsoft 365, use m365_create_event.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para create_calendar_event. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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