Work IQ-Kalenderreferenz (Vorschau)

Important

Dies ist eine Vorschaufunktion.

  • Microsoft veröffentlicht Vorschaufeatures vor einer offiziellen Version, sodass Kunden frühzeitig Zugriff erhalten und Feedback geben können.
  • Vorschaufeatures verfügen über eingeschränkte Funktionen und sind nicht für die Produktionsverwendung vorgesehen.
  • Microsoft kann Vorschau-MCP-Toolnamen und -parameter ändern. Vermeiden Sie hartcodierte Abhängigkeiten. Microsoft behält die Szenariounterstützung bei.
  • Vorschaufunktionen unterliegen den ergänzenden Nutzungsbedingungen von Microsoft.

Übersicht

Server-ID URL auf Mandantenebene Anzeigename Description
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools
Arbeits-IQ-Kalender MCP-Server für Kalendertools. Verwenden Sie diesen MCP-Server für Kalendervorgänge wie Erstellen, Aktualisieren, Abrufen von Ereignissen, Verwalten von Einladungen und Überprüfen der Verfügbarkeit.

Verfügbare Tools

mcp_CalendarTools_graph_acceptEvent

Akzeptieren Sie die angegebene Ereigniseinladung im Kalender eines Benutzers.

Erforderliche Parameter:

  • eventId: Die ID des zu akzeptierenden Ereignisses

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName
  • Kommentar: Optionaler Text, der in der Antwort enthalten ist
  • sendResponse: Gibt an, ob antwort an den Organisator gesendet werden soll

mcp_CalendarTools_graph_cancelEvent

Abbrechen eines Ereignisses im Kalender eines bestimmten Benutzers und Benachrichtigen von Teilnehmern.

Erforderliche Parameter:

  • eventId: Der eindeutige Bezeichner des ereignisses, das abgebrochen werden soll

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName
  • Kommentar: Optionale Abbruchnachricht

mcp_CalendarTools_graph_createEvent

Erstellen Sie ein neues Kalenderereignis im Kalender eines bestimmten Benutzers. Unterstützt wiederkehrende Ereignisse und Onlinebesprechungen.

Erforderliche Parameter:

  • subject: Betreff oder Titel des Ereignisses (nicht leer)
  • start: Startzeitstempel mit dateTime und timeZone
  • Ende: Endzeitstempel mit dateTime und timeZone
  • attendees_addresses: Array von Teilnehmer-E-Mail-Adressen

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName
  • Körper: Ereigniskörper mit contentType (Text/HTML) und Inhalt
  • location: Standort mit displayName
  • attendees_types: Teilnehmerrollen (erforderlich, optional, Ressource)
  • attendees_names: Anzeigenamen der Teilnehmer
  • Wiederholung: Wiederholungsmuster und -umfang
  • isOnlineMeeting: Für Onlinebesprechung auf "true" festgelegt
  • onlineMeetingProvider: teamsForBusiness, skypeForBusinessskypeForConsumer
  • allowNewTimeProposals: Zeitvorschläge zulassen (Standard: true)
  • transactionId: Idempotence Kennung

mcp_KalenderWerkzeuge_graph_EreignisAblehnen

Lehnen Sie die angegebene Ereigniseinladung im Kalender eines Benutzers ab.

Erforderliche Parameter:

  • eventId: Die ID des Ereignisses, das abgelehnt werden soll

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName

  • kommentar: Optionaler Text als Antwort

  • sendResponse: Gibt an, ob Antwort gesendet werden soll

mcp_CalendarTools_graph_deleteEvent

Löschen eines Ereignisses aus dem Kalender eines bestimmten Benutzers.

Erforderliche Parameter:

  • eventId: Der eindeutige Bezeichner des zu löschenden Ereignisses

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Vorschlagen von Besprechungszeiten und -orten basierend auf der Verfügbarkeit des Organisators und der Teilnehmer.

Erforderliche Parameter:

  • meetingDuration: Besprechungsdauer (z. B. "PT1H")

Optionale Parameter:

  • userId: Organisator-ID oder userPrincipalName
  • attendees_addresses: E-Mail-Adressen des Teilnehmers
  • attendees_types: Teilnehmertypen
  • attendees_names: Anzeigenamen der Teilnehmer
  • timeConstraint: Zeitverfügbarkeit mit timeslots und activityDomain
  • locationConstraint: Standortoptionen
  • maxCandidates: Maximale Vorschläge
  • isOrganizerOptional: Optionale Kennzeichnung "Organizer"
  • returnSuggestionReasons: Einschließen von Gründen
  • minimumAttendeePercentage: Minimale Anwesenheitsschwelle

mcp_CalendarTools_graph_getEvent

Rufen Sie ein einzelnes Kalenderereignis aus dem Kalender eines bestimmten Benutzers ab.

Erforderliche Parameter:

  • eventId: Der eindeutige Bezeichner des Ereignisses

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName
  • select: OData-Abfrageparameter \$select
  • expand: OData \$expand für Navigationseigenschaften

mcp_CalendarTools_graph_getSchedule

Rufen Sie den Frei/Gebucht-Zeitplan für einen Benutzer, eine Verteilerliste oder Ressource ab.

Erforderliche Parameter:

  • Zeitpläne: SMTP-Adressen von Benutzern oder Ressourcen
  • startTime: Startzeit mit dateTime und timeZone
  • endTime: Endzeit mit dateTime und timeZone

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName
  • availabilityViewInterval: Zeitfensterlänge in Minuten

mcp_CalendarTools_graph_listKalenderansicht

Dient zum Abrufen von Kalendervorkommnissen innerhalb eines angegebenen Zeitraums für einen Benutzer.

Erforderliche Parameter:

  • startDateTime: Anfang des Zeitraums (ISO 8601)
  • endDateTime: Ende des Zeitraums (ISO 8601)

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName
  • top: Maximale Anzahl von Ereignissen
  • orderby: ORDER BY-Klausel

mcp_CalendarTools_graph_listEvents

Dient zum Abrufen einer Liste von Ereignissen aus dem Kalender eines bestimmten Benutzers.

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName
  • startDateTime: Anfang des Zeitraums (ISO 8601)
  • endDateTime: Ende des Zeitraums (ISO 8601)
  • top: Maximale Anzahl von Ereignissen
  • filter: OData-Filterabfrage
  • orderby: OData Abfrage nach Reihenfolge

mcp_CalendarTools_graph_updateEvent

Aktualisieren eines vorhandenen Kalenderereignisses im Kalender eines bestimmten Benutzers.

Erforderliche Parameter:

  • eventId: Der eindeutige Bezeichner des Ereignisses

Optionale Parameter:

  • userId: Benutzer-ID oder userPrincipalName
  • subject: Aktualisierter Betreff
  • body: Aktualisierter Textkörperinhalt
  • start: Aktualisierte Startzeit
  • end: Aktualisierte Endzeit
  • Speicherort: Aktualisierter Speicherort
  • attendees_addresses: Aktualisierte Teilnehmer-E-Mails
  • attendees_types: Aktualisierte Teilnehmertypen
  • attendees_names: Aktualisierte Teilnehmernamen
  • isCancelled: Auf "true" festgelegt, um den Vorgang abzubrechen
  • Wiederholung: Aktualisiertes Wiederholungsmuster

Wichtigste Funktionen

Ereignisverwaltung

  • Erstellen, Lesen, Aktualisieren sowie Löschen von Ereignissen
  • Annehmen, Ablehnen und Abbrechen von Einladungen
  • Unterstützung für wiederkehrende Ereignisse
  • Integration in Onlinebesprechungen (Teams, Skype)

Verfügbarkeit und Zeitplanung

  • Frei/belegt Zeitpläne abrufen
  • Suchen von Besprechungszeiten mit Verfügbarkeitsprüfung
  • Kalenderansicht mit Zeitrahmenfilterung
  • Analyse der Teilnehmerverfügbarkeit

Teilnehmerverwaltung

  • Verwalten von erforderlichen, optionalen und Ressourcenbeteiligten
  • Unterstützung für Terminvorschläge
  • Antworten nachverfolgen
  • Unterstützung für Verteilerlisten

Wiederholungsmuster

  • Tägliche, wöchentliche, monatliche und jährliche Muster
  • Absolute und relative Wiederholung
  • Enddatum oder Anzahl der Vorkommnisse
  • Wochentags- und Monatsspezifikationen

Online Besprechungen

  • Integration mit Teams für Unternehmen
  • Unterstützung für Skype for Business
  • Unterstützung für Skype (für den persönlichen Gebrauch)
  • Automatische Generierung von Besprechungslinks

Hinweise

  • Alle Zeitstempel verwenden das UTC/ISO 8601-Format mit Zeitzone
  • Calendar MCP ist darauf angewiesen UserprofileMCP , Nutzer innerhalb der Organisation zu finden
  • E-Mail-Adressen müssen ein gültiges Format haben
  • Teilnehmerarrays (Adressen, Typen, Namen) müssen in derselben Reihenfolge sein
  • Online-Meetings erfordern isOnlineMeeting=true und onlineMeetingProvider
  • Wiederholungen erfordern sowohl Muster- als auch Bereichsobjekte
  • Zeitzonen sollten über Start- und Endzeiten hinweg konsistent sein
  • TransactionId ermöglicht die Erstellung idempotent von Ereignissen