Zur Dokumentation springen
MCP-Server

Kalender

Termine und Einladungen.

Kalender-Tools

ToolWas es tut
listCalendarEventsJedes Vorkommen zwischen zwei Zeitpunkten, ein sich wiederholender Termin einmal für jedes Mal, mit Ort, Status und Ihrer Antwort.
getCalendarEventEin Termin vollständig, über id oder über die threadId der Unterhaltung, die seine Einladung trägt: die Teilnehmer und ihre Antworten, wie er sich wiederholt und seine Erinnerungen.
createCalendarEventEinen Termin in den Kalender eintragen und die Teilnehmer von einer Adresse einladen, von der Sie senden dürfen. Im Chat der App fragt es zuerst, außer Sie haben darum gebeten.
updateCalendarEventEinen Termin ändern, den Sie organisieren, und die Aktualisierung an alle Eingeladenen senden. Im Chat der App fragt es zuerst, außer Sie haben darum gebeten.
cancelCalendarEventEine Besprechung absagen, die Sie organisieren, und alle Eingeladenen benachrichtigen. Im Chat der App fragt es immer zuerst.
deleteCalendarEventEinen Termin aus dem Kalender nehmen, ohne jemandem Bescheid zu geben. Im Chat der App fragt es immer zuerst.
respondToCalendarEventEine Einladung annehmen, ablehnen oder vorläufig annehmen und es dem Organisator mitteilen. Im Chat der App fragt es zuerst, außer Sie haben darum gebeten.

Lesen erfordert calendar:read und jede Änderung calendar:write. Alles, was jemandem eine E-Mail schickt, erfordert auch emails:send: Einladungen, Aktualisierungen oder Absagen einer Besprechung mit Teilnehmern und jede Antwort auf eine Einladung.

Ein auf einige Adressen beschränkter Client sieht und ändert nur die Termine, die eine davon organisiert oder an denen sie teilnimmt, und sendet nur von ihnen.

Referenz

listCalendarEvents

Geltungsbereichecalendar:readDer Assistent in der App führt es ohne Nachfrage ausToolkitcalendar

The calendar between two moments, as the Calendar page of the app shows it: every occurrence in the window, a repeating event once for each time it happens, sorted by start, with its event id, place, status and your answer. from and to are ISO 8601 with a zone, at most a year apart, and timezone (an IANA zone, UTC unless you say) decides what an all-day event means. When more follow, the last line gives the offset to pass back.

Eingaben

fromstringErforderlich
Formatdate-time
tostringErforderlich
Formatdate-time
timezonestring
1 bis 64 Zeichen
limitinteger
Mindestens 1Höchstens 200
offsetinteger
Mindestens 0

Auch verfügbar über

API
GET /calendar/events
SDK
calendar.listEvents()calendar.listAllEvents()calendar.iterateEvents()

getCalendarEvent

Geltungsbereichecalendar:readDer Assistent in der App führt es ohne Nachfrage ausToolkitcalendar

One calendar event in full: when it is, where, who organised it, every attendee and their answer, your own answer, how it repeats and its reminders. Pass id for an event from listCalendarEvents, or threadId for the invitation a conversation carries.

Eingaben

idstring
1 bis 64 Zeichen
threadIdstring
1 bis 256 Zeichen

Auch verfügbar über

API
GET /calendar/events/{id}GET /threads/{id}/event
SDK
calendar.getEvent()threads.getEvent()

createCalendarEvent

Geltungsbereichecalendar:writeDer Assistent in der App fragt zuerst nach, außer Sie haben darum gebetenToolkitcalendar

Put an event on the calendar, as New event on the Calendar page does. start and end are ISO 8601 with a zone. With attendees, an invitation goes to each of them from the address in from, which has to be one you may send as, unless sendInvites is false. reminders takes minutes before the start, and recurrence an RRULE such as FREQ=WEEKLY;BYDAY=MO.

Eingaben

summarystringErforderlich
1 bis 255 Zeichen
startstringErforderlich
Formatdate-time
endstringErforderlich
Formatdate-time
descriptionstring
Bis zu 8000 Zeichen
locationstring
Bis zu 255 Zeichen
urlstring
Bis zu 2000 ZeichenFormaturi
allDayboolean
timezonestring
1 bis 64 Zeichen
recurrencestring
Bis zu 512 Zeichen
attendeesobject[]
Bis zu 200 Einträge
emailstringErforderlich
Bis zu 320 ZeichenFormatemail
namestring
Bis zu 128 Zeichen
optionalboolean
remindersobject[]
Bis zu 5 Einträge
minutesBeforeintegerErforderlich
Mindestens 0Höchstens 40320
sendInvitesboolean
fromstring
Bis zu 320 Zeichen

Auch verfügbar über

API
POST /calendar/events
SDK
calendar.createEvent()

updateCalendarEvent

Geltungsbereichecalendar:writeDer Assistent in der App fragt zuerst nach, außer Sie haben darum gebetenToolkitcalendar

Change an event you organise: its title, time, place, attendees, reminders or repeating. A field left out keeps its value, and attendees replaces the whole list. Everyone invited gets the updated invitation unless sendInvites is false.

Eingaben

idstringErforderlich
1 bis 64 Zeichen
summarystring
1 bis 255 Zeichen
startstring
Formatdate-time
endstring
Formatdate-time
descriptionstring
Bis zu 8000 Zeichen
locationstring
Bis zu 255 Zeichen
urlstring
Bis zu 2000 ZeichenFormaturi
allDayboolean
timezonestring
1 bis 64 Zeichen
recurrencestring
Bis zu 512 Zeichen
attendeesobject[]
Bis zu 200 Einträge
emailstringErforderlich
Bis zu 320 ZeichenFormatemail
namestring
Bis zu 128 Zeichen
optionalboolean
remindersobject[]
Bis zu 5 Einträge
minutesBeforeintegerErforderlich
Mindestens 0Höchstens 40320
sendInvitesboolean
fromstring
Bis zu 320 Zeichen

Auch verfügbar über

API
PATCH /calendar/events/{id}
SDK
calendar.updateEvent()

cancelCalendarEvent

Geltungsbereichecalendar:writeDer Assistent in der App fragt immer zuerst nachToolkitcalendar

Call off a meeting you organise, as Cancel meeting does in the app: it stays on the calendar marked cancelled, and everyone invited is told it is off, from the address in from. A chat always asks first.

Eingaben

idstringErforderlich
1 bis 64 Zeichen
fromstring
Bis zu 320 Zeichen

Auch verfügbar über

API
POST /calendar/events/{id}/cancel
SDK
calendar.cancelEvent()

deleteCalendarEvent

Geltungsbereichecalendar:writeDer Assistent in der App fragt immer zuerst nachToolkitcalendar

Remove an event from the calendar for good, as Remove does in the app. Nobody else is told, so call off a meeting with others in it with cancelCalendarEvent instead. A chat always asks first.

Eingaben

idstringErforderlich
1 bis 64 Zeichen

Auch verfügbar über

API
DELETE /calendar/events/{id}
SDK
calendar.deleteEvent()

respondToCalendarEvent

Geltungsbereichecalendar:writeDer Assistent in der App fragt zuerst nach, außer Sie haben darum gebetenToolkitcalendar

Answer an invitation: ACCEPTED, DECLINED or TENTATIVE. The answer goes to the organiser by email from the invited address you may send as, or from respondingAs when the invitation went to more than one of yours.

Eingaben

idstringErforderlich
1 bis 64 Zeichen
responsestringErforderlich
Einer von"ACCEPTED""DECLINED""TENTATIVE"
respondingAsstring
Bis zu 320 Zeichen

Auch verfügbar über

API
POST /calendar/events/{id}/respond
SDK
calendar.respondToEvent()