Compartilhar via

Referência do servidor MCP do Microsoft Outlook Calendar

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Visão geral

ID de servidor Display name Description
mcp_CalendarTools Servidor MCP do Calendário Microsoft Outlook Servidor MCP para ferramentas de calendário. Use este servidor MCP para operações de calendário, como criar, atualizar, recuperar eventos, gerenciar convites e verificar a disponibilidade.

Ferramentas disponíveis

mcp_CalendarTools_graph_acceptEvent

Aceite o convite para o evento especificado no calendário do usuário.

Parâmetros obrigatórios

  • eventId: O ID do evento a aceitar

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName
  • comentário: Texto opcional incluído na resposta
  • sendResponse: Se deve enviar resposta ao organizador

mcp_CalendarTools_graph_cancelEvent

Cancele um evento no calendário de um usuário específico e notifique os participantes.

Parâmetros obrigatórios

  • eventId: O identificador único do evento a ser cancelado

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName
  • comentário: Mensagem de cancelamento opcional

mcp_CalendarTools_graph_createEvent

Crie um novo evento no calendário de um usuário específico. Apoia eventos recorrentes e reuniões online.

Parâmetros obrigatórios

  • assunto: Assunto/título do evento (não vazio)
  • Início: Carimbo de hora de início com dataHora e Fuso Horário
  • fim: Fim do carimbo de tempo com dataHora e Fuso Horário
  • attendees_addresses: Variedade de endereços de e-mail dos participantes

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName
  • corpo: Corpo do evento com contentType (Texto/HTML) e conteúdo
  • localização: Localização com displayName
  • attendees_types: Funções dos participantes (obrigatórias, opcionais, de recurso)
  • attendees_names: Os participantes exibem os nomes
  • Recidiva: Padrão e alcance de recorrência
  • isOnlineMeeting: Definido para true para encontros online
  • ProvedorReuniãoOnline: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: Permitir propostas de tempo (padrão: verdadeiro)
  • transactionId: identificador de idempotência

mcp_CalendarTools_graph_declineEvent

Recuse o convite para evento especificado no calendário do usuário.

Parâmetros obrigatórios

  • eventId: O ID do evento a declinar

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName

  • comentário: Texto opcional em resposta

  • sendResponse: Se deve enviar resposta

mcp_CalendarTools_graph_deleteEvent

Exclua um evento do calendário de um usuário específico.

Parâmetros obrigatórios

  • eventId: O identificador único do evento a ser excluído

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugera horários e locais de reunião com base na disponibilidade do organizador e dos participantes.

Parâmetros obrigatórios

  • Duração da reunião: Duração da reunião (por exemplo, 'PT1H')

Parâmetros opcionais:

  • userId: ID do organizador ou userPrincipalName
  • attendees_addresses: Endereços de e-mail dos participantes
  • attendees_types: Tipos de participantes
  • attendees_names: Os participantes exibem os nomes
  • timeConstraint: Disponibilidade de tempo com intervalos de tempo e activityDomain
  • restrição de localização: Opções de localização
  • maxCandidates: Sugestões máximas
  • isOrganizerOptional: Flag opcional de organizador
  • returnSugestãoRazões: Incluir razões
  • mínimoPercentualParticipante: Limiar mínimo de presença

mcp_CalendarTools_graph_getEvent

Obtenha um único evento do calendário de um usuário específico.

Parâmetros obrigatórios

  • EVENTID – o identificador de evento da entrada de log.

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName
  • select: OData $select parâmetro de consulta
  • expandir: OData $expand para propriedades de navegação

mcp_CalendarTools_graph_getSchedule

Obtenha a agenda livre/movimentada para um usuário, lista de distribuição ou recurso.

Parâmetros obrigatórios

  • agendas: endereços SMTP de usuários ou recursos
  • Hora de início: Hora de início com dataHora e fuso horário
  • fimHora: Hora de fim com dataHora e fusoHorário

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName
  • availabilityViewInterval: Duração do intervalo de tempo em minutos

mcp_CalendarTools_graph_listCalendarView

Recupere ocorrências do calendário dentro de um intervalo de tempo especificado para o usuário.

Parâmetros obrigatórios

  • startDateTime: Início do intervalo de tempo (ISO 8601)
  • fimTempoTempo: Fim do intervalo de tempo (ISO 8601)

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName
  • topo: Número máximo de eventos
  • orderby: Order por cláusula

mcp_CalendarTools_graph_listEvents

Recupere uma lista de eventos do calendário de um usuário especificado.

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName
  • startDateTime: Início do intervalo de tempo (ISO 8601)
  • fimTempoTempo: Fim do intervalo de tempo (ISO 8601)
  • O número máximo de eventos.
  • filter: consulta de filtro OData
  • orderby: OData order por consulta

mcp_CalendarTools_graph_updateEvent

Atualize um evento de calendário existente no calendário de um usuário específico.

Parâmetros obrigatórios

  • EVENTID – o identificador de evento da entrada de log.

Parâmetros opcionais:

  • userId: ID de usuário ou userPrincipalName
  • assunto: Assunto atualizado
  • corpo: Conteúdo atualizado do corpo
  • Início: Horário de início atualizado
  • fim: Hora de fim atualizada
  • localização: Localização atualizada
  • attendees_addresses: E-mails atualizados dos participantes
  • attendees_types: Tipos atualizados de participantes
  • attendees_names: Nomes atualizados dos participantes
  • isCancelled: Defina para true para cancelar
  • Recidiva: Padrão de recorrência atualizado

Recursos principais

Gerenciamento de eventos

  • Criar, ler, atualizar e excluir
  • Aceite, recuse e cancele convites
  • Suporte a eventos recorrentes
  • Integração com reuniões online (Teams, Skype)

Comandos de disponibilidade e agendamento

  • Tenha horários livres/ocupados
  • Encontre horários de encontros com verificação de disponibilidade
  • Visualização de calendário com filtragem por intervalo de tempo
  • Análise da disponibilidade dos participantes

Gestão dos participantes

  • Gerencie participantes obrigatórios, opcionais e de recursos
  • Apoio a propostas de tempo
  • Rastrear resposta
  • Suporte para listas de distribuição

Padrão de recorrência

  • Diária, semanal, mensal e anual.
  • Recorrência absoluta e relativa
  • Data de término ou contagem de ocorrências
  • Especificações do dia da semana e do mês

Reuniões online

  • Integração com o Teams for Business
  • Suporte ao Skype for Business.
  • Suporte ao Skype para Consumidores
  • Geração automática de links de encontro

Notes

  1. Todos os timestamps são retornados no formato UTC, ISO 8601:
  2. O Calendar MCP depende do UserprofileMCP para encontrar usuários na organização
  3. O email precisa ter um formato válido.
  4. Os arrays dos participantes (endereços, tipos, nomes) devem estar na mesma ordem
  5. Reuniões online exigem isOnlineMeeting=true e onlineMeetingProvider
  6. A recorrência requer tanto objetos padrão quanto de alcance
  7. Os fusos horários devem ser consistentes entre os horários de início e fim
  8. O TransactionId possibilita a criação de eventos idempotentes
  • Last updated on