Partager via


Référence du serveur MCP de Calendrier Microsoft Outlook

Important

Vous devez faire partie du programme Frontier en version préliminaire pour obtenir un accès anticipé à Microsoft Agent 365. Frontier vous connecte directement aux dernières innovations d’IA de Microsoft. Les versions préliminaires Frontier sont soumises aux conditions existantes de vos contrats clients qui régissent les versions préliminaires. Comme ces fonctionnalités sont encore en cours de développement, leur disponibilité et leurs capacités peuvent évoluer au fil du temps.

Vue d’ensemble

ID du serveur Nom d’affichage Description
mcp_CalendarTools Serveur MCP de Calendrier Microsoft Outlook Serveur MCP pour les outils de calendrier. Utilisez ce serveur MCP pour les opérations de calendrier telles que la création, la mise à jour, la récupération d’événements, la gestion des invitations et la vérification de la disponibilité.

Outils disponibles

mcp_CalendarTools_graph_acceptEvent

Acceptez l’invitation d’événement spécifiée dans le calendrier d’un utilisateur.

Paramètres obligatoires :

  • eventId : ID de l’événement à accepter

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName
  • comment : texte facultatif inclus dans la réponse
  • sendResponse : indique s’il faut envoyer une réponse à l’organisateur

mcp_CalendarTools_graph_cancelEvent

Annulez un événement dans le calendrier d’un utilisateur spécifié et informez les participants.

Paramètres obligatoires :

  • eventId : identificateur unique de l’événement à annuler

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName
  • comment : Message d’annulation facultatif

mcp_CalendarTools_graph_createEvent

Créez un événement de calendrier dans le calendrier d’un utilisateur spécifié. Prend en charge les événements récurrents et les réunions en ligne.

Paramètres obligatoires :

  • subject : Objet/titre de l’événement (non vide)
  • start : démarrage de l’horodateur avec dateTime et timeZone
  • end : Horodateur de fin avec dateTime et timeZone
  • attendees_addresses : tableau d’adresses e-mail des participants

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName
  • body : corps d’événement avec contentType (Text/HTML) et contenu
  • location : Emplacement avec displayName
  • attendees_types : Rôles de participant (obligatoires, facultatifs, ressources)
  • attendees_names : Noms d’affichage des participants
  • périodicité : modèle et plage de périodicité
  • isOnlineMeeting : défini sur true pour la réunion en ligne
  • onlineMeetingProvider : teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals : Autoriser les propositions de temps (valeur par défaut : true)
  • transactionId : identificateur Idempotence

mcp_CalendarTools_graph_declineEvent

Refusez l’invitation d’événement spécifiée dans le calendrier d’un utilisateur.

Paramètres obligatoires :

  • eventId : ID de l’événement à refuser

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName

  • comment : texte facultatif dans la réponse

  • sendResponse : indique s’il faut envoyer une réponse

mcp_CalendarTools_graph_deleteEvent

Supprimez un événement du calendrier d’un utilisateur spécifié.

Paramètres obligatoires :

  • eventId : identificateur unique de l’événement à supprimer

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Suggérez des heures et des emplacements de réunion en fonction de la disponibilité de l’organisateur et des participants.

Paramètres obligatoires :

  • meetingDuration : durée de la réunion (par exemple, « PT1H »)

Paramètres facultatifs :

  • userId : identifiant organisateur ou userPrincipalName
  • attendees_addresses : adresses e-mail des participants
  • attendees_types : types de participants
  • attendees_names : Noms d’affichage des participants
  • timeConstraint : disponibilité temporaire avec intervalles de temps et activityDomain
  • locationConstraint : options d’emplacement
  • maxCandidates : suggestions maximales
  • isOrganizerOptional : indicateur facultatif de l’organisateur
  • returnSuggestionReasons : inclure des raisons
  • minimumAttendeePercentage : seuil de présence minimal

mcp_CalendarTools_graph_getEvent

Obtenez un événement de calendrier unique à partir du calendrier d’un utilisateur spécifié.

Paramètres obligatoires :

  • eventId : identificateur unique de l’événement

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName
  • select : paramètre de requête OData $select
  • expand : OData $expand pour les propriétés de navigation

mcp_CalendarTools_graph_getSchedule

Obtenez la planification de disponibilité pour un utilisateur, une liste de distribution ou une ressource.

Paramètres obligatoires :

  • schedules : adresses SMTP des utilisateurs ou des ressources
  • startTime : Heure de début avec dateTime et timeZone
  • endTime : Heure de fin avec dateTime et timeZone

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName
  • availabilityViewInterval : durée du créneau en minutes

mcp_CalendarTools_graph_listCalendarView

Récupérez les occurrences de calendrier dans un intervalle de temps spécifié pour un utilisateur.

Paramètres obligatoires :

  • startDateTime : début de l’intervalle de temps (ISO 8601)
  • endDateTime : Fin de l’intervalle de temps (ISO 8601)

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName
  • top : nombre maximal d’événements
  • orderby : commande par clause

mcp_CalendarTools_graph_listEvents

Récupérez une liste d’événements à partir du calendrier d’un utilisateur spécifié.

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName
  • startDateTime : début de l’intervalle de temps (ISO 8601)
  • endDateTime : Fin de l’intervalle de temps (ISO 8601)
  • top : nombre maximal d’événements
  • filter : requête de filtre OData
  • orderby : commande OData par requête

mcp_CalendarTools_graph_updateEvent

Mettez à jour un événement de calendrier existant dans le calendrier d’un utilisateur spécifié.

Paramètres obligatoires :

  • eventId : identificateur unique de l’événement

Paramètres facultatifs :

  • userId : identifiant utilisateur ou userPrincipalName
  • objet : Objet mis à jour
  • corps : Contenu du corps mis à jour
  • start : Heure de début mise à jour
  • end : heure de fin mise à jour
  • location : emplacement mis à jour
  • attendees_addresses : courriers électroniques des participants mis à jour
  • attendees_types : Types de participants mis à jour
  • attendees_names : Noms des participants mis à jour
  • isCancelled : définir sur true pour annuler
  • recurrence : Modèle de périodicité mise à jour

Fonctionnalités clés

Gestion d’événement

  • Créer, lire, mettre à jour et supprimer les événements
  • Accepter, refuser et annuler des invitations
  • Prise en charge des événements périodiques
  • Intégration à des réunions en ligne (Teams, Skype)

Disponibilité et planification

  • Obtenir des planifications gratuites/occupées
  • Rechercher les heures de réunion avec la vérification de la disponibilité
  • Affichage Calendrier avec filtrage d’intervalles de temps
  • Analyse de la disponibilité des participants

Gestion des participants

  • Gérer les participants requis, facultatifs et de ressources
  • Prise en charge des propositions temporelles
  • Suivre les réponses
  • Prise en charge des listes de distribution

Critères de périodicité

  • Chaque jour, chaque semaine, deux fois par semaine, chaque mois et chaque année
  • Périodicité absolue et relative
  • Date de fin ou nombre d’occurrences
  • Spécifications de jour de semaine et de mois

Réunions en ligne

  • Intégration à Teams for Business
  • Assistance pour Skype Entreprise
  • Assistance pour Skype Consommateurs
  • Génération automatique de liens de réunion

Notes

  1. Tous les horodatages utilisent le format UTC/ISO 8601 avec fuseau horaire
  2. Calendar MCP s’appuie sur UserprofileMCP pour rechercher des utilisateurs dans l’organisation
  3. Les adresses de messagerie doivent être un format valide
  4. Les tableaux de participants (adresses, types, noms) doivent être dans le même ordre
  5. Les réunions en ligne nécessitent isOnlineMeeting=true et onlineMeetingProvider
  6. La périodicité nécessite à la fois des objets de modèle et de plage
  7. Les fuseaux horaires doivent être cohérents entre les heures de début et de fin
  8. TransactionId active la création d’événements idempotent