Ir para o conteúdo
Todas as ferramentas

m365_create_event

Microsoft 365 · macOS · Windows

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 calendário do Microsoft 365 / Outlook conectado. Se `attendees` estiver definido, o Microsoft 365 envia por e-mail um convite de reunião a cada um deles assim que o evento é criado: criar com attendees É enviar convites, por isso confirme a lista com o usuário primeiro. As horas são lidas em `timezone`, que por padrão é UTC (não a hora deste Mac, ao contrário de create_calendar_event) — passe o fuso horário do usuário ou o evento ficará à hora errada; a prévia avisa quando não foi indicado fuso horário. Usa o calendário principal, a menos que `calendar` indique outro. Chamada sem confirm, retorna uma prévia de todos os campos e não altera nada; passe confirm=true para criar. Retorna o id do evento. Para a app Calendário do Mac, use create_calendar_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": {
    "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"
}

Exemplo documental

Exemplo de documentação para m365_create_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": "2026-10-06T11:00:00",
  "start": "2026-10-06T10:00:00",
  "subject": "Planning meeting"
}

Windows

Finalidade

Cria um evento no calendário padrão da conta do Microsoft 365 conectada com connect_m365_account, pelo Microsoft Graph (para o app de desktop do Outlook, use outlook_calendar_create_event). Sem confirm=true, nada é criado nem enviado: a chamada retorna uma prévia de todos os campos, sem contatar o Microsoft 365, então mostre-a ao usuário. Com confirm=true, o evento é criado, cada endereço em `attendees` é adicionado como participante obrigatório e o Microsoft 365 envia a cada um um convite de reunião. `start` e `end` são lidos em `timezone`, cujo padrão é UTC, não o fuso local do usuário: passe-o. Nada verifica se já existe um evento, então confirmar duas vezes cria dois. A resposta traz o ID do evento, que m365_delete_event aceita para removê-lo; este servidor não tem ferramenta para editar um.

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 — 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"
}

Exemplo documental

Exemplo de documentação para m365_create_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": "2026-10-06T11:00:00",
  "start": "2026-10-06T10:00:00",
  "subject": "Planning meeting"
}