Ir a la documentación
Servidor MCP

Calendario

Eventos e invitaciones.

Herramientas de calendario

HerramientaQué hace
listCalendarEventsCada ocurrencia entre dos momentos, un evento que se repite una vez por cada vez que sucede, con su lugar, su estado y tu respuesta.
getCalendarEventUn evento completo, por id o por el threadId de la conversación que lleva su invitación: los asistentes y sus respuestas, cómo se repite y sus recordatorios.
createCalendarEventPon un evento en el calendario e invita a los asistentes desde una dirección desde la que puedas enviar. En el chat de la app pregunta primero salvo que lo hayas pedido.
updateCalendarEventCambia un evento que organizas y envía la actualización a todos los invitados. En el chat de la app pregunta primero salvo que lo hayas pedido.
cancelCalendarEventCancela una reunión que organizas y avisa a todos los invitados. En el chat de la app siempre pregunta primero.
deleteCalendarEventQuita un evento del calendario sin avisar a nadie. En el chat de la app siempre pregunta primero.
respondToCalendarEventAcepta, rechaza o acepta provisionalmente una invitación, y avisa al organizador. En el chat de la app pregunta primero salvo que lo hayas pedido.

Leer requiere calendar:read y cada cambio calendar:write. Todo lo que envía un correo a alguien también requiere emails:send: invitar, actualizar o cancelar una reunión con asistentes, y cada respuesta a una invitación.

Un cliente limitado a algunas direcciones solo ve y cambia los eventos que una de ellas organiza o a los que asiste, y solo envía desde ellas.

Referencia

listCalendarEvents

Alcancescalendar:readEl asistente de la app lo ejecuta sin preguntarKit de herramientascalendar

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.

Entradas

fromstringObligatorio
Formatodate-time
tostringObligatorio
Formatodate-time
timezonestring
De 1 a 64 caracteres
limitinteger
Al menos 1Como máximo 200
offsetinteger
Al menos 0

También disponible en

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

getCalendarEvent

Alcancescalendar:readEl asistente de la app lo ejecuta sin preguntarKit de herramientascalendar

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.

Entradas

idstring
De 1 a 64 caracteres
threadIdstring
De 1 a 256 caracteres

También disponible en

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

createCalendarEvent

Alcancescalendar:writeEl asistente de la app pregunta antes, salvo que tú lo hayas pedidoKit de herramientascalendar

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.

Entradas

summarystringObligatorio
De 1 a 255 caracteres
startstringObligatorio
Formatodate-time
endstringObligatorio
Formatodate-time
descriptionstring
Hasta 8000 caracteres
locationstring
Hasta 255 caracteres
urlstring
Hasta 2000 caracteresFormatouri
allDayboolean
timezonestring
De 1 a 64 caracteres
recurrencestring
Hasta 512 caracteres
attendeesobject[]
Hasta 200 elementos
emailstringObligatorio
Hasta 320 caracteresFormatoemail
namestring
Hasta 128 caracteres
optionalboolean
remindersobject[]
Hasta 5 elementos
minutesBeforeintegerObligatorio
Al menos 0Como máximo 40320
sendInvitesboolean
fromstring
Hasta 320 caracteres

También disponible en

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

updateCalendarEvent

Alcancescalendar:writeEl asistente de la app pregunta antes, salvo que tú lo hayas pedidoKit de herramientascalendar

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.

Entradas

idstringObligatorio
De 1 a 64 caracteres
summarystring
De 1 a 255 caracteres
startstring
Formatodate-time
endstring
Formatodate-time
descriptionstring
Hasta 8000 caracteres
locationstring
Hasta 255 caracteres
urlstring
Hasta 2000 caracteresFormatouri
allDayboolean
timezonestring
De 1 a 64 caracteres
recurrencestring
Hasta 512 caracteres
attendeesobject[]
Hasta 200 elementos
emailstringObligatorio
Hasta 320 caracteresFormatoemail
namestring
Hasta 128 caracteres
optionalboolean
remindersobject[]
Hasta 5 elementos
minutesBeforeintegerObligatorio
Al menos 0Como máximo 40320
sendInvitesboolean
fromstring
Hasta 320 caracteres

También disponible en

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

cancelCalendarEvent

Alcancescalendar:writeEl asistente de la app siempre pregunta antesKit de herramientascalendar

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.

Entradas

idstringObligatorio
De 1 a 64 caracteres
fromstring
Hasta 320 caracteres

También disponible en

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

deleteCalendarEvent

Alcancescalendar:writeEl asistente de la app siempre pregunta antesKit de herramientascalendar

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.

Entradas

idstringObligatorio
De 1 a 64 caracteres

También disponible en

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

respondToCalendarEvent

Alcancescalendar:writeEl asistente de la app pregunta antes, salvo que tú lo hayas pedidoKit de herramientascalendar

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.

Entradas

idstringObligatorio
De 1 a 64 caracteres
responsestringObligatorio
Uno de"ACCEPTED""DECLINED""TENTATIVE"
respondingAsstring
Hasta 320 caracteres

También disponible en

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