문서로 건너뛰기
MCP 서버

캘린더

일정과 초대.

캘린더 도구

도구하는 일
listCalendarEvents두 시점 사이의 모든 회차. 반복 일정은 회차마다 한 번씩 나오며, 장소, 상태, 내 응답이 함께 나옵니다.
getCalendarEvent일정 하나의 전체. id로, 또는 초대가 담긴 대화의 threadId로 지정합니다. 참석자와 그 응답, 반복 방식, 알림이 포함됩니다.
createCalendarEvent일정을 캘린더에 넣고, 보낼 수 있는 주소에서 참석자를 초대합니다. 앱의 채팅에서는 요청하지 않았다면 먼저 묻습니다.
updateCalendarEvent주최하는 일정을 바꾸고 초대한 모든 사람에게 업데이트를 보냅니다. 앱의 채팅에서는 요청하지 않았다면 먼저 묻습니다.
cancelCalendarEvent주최하는 회의를 취소하고 초대한 모든 사람에게 알립니다. 앱의 채팅에서는 항상 먼저 묻습니다.
deleteCalendarEvent아무에게도 알리지 않고 일정을 캘린더에서 뺍니다. 앱의 채팅에서는 항상 먼저 묻습니다.
respondToCalendarEvent초대를 수락, 거절 또는 잠정 수락하고 주최자에게 알립니다. 앱의 채팅에서는 요청하지 않았다면 먼저 묻습니다.

읽기에는 calendar:read가, 모든 변경에는 calendar:write가 필요합니다. 누군가에게 이메일을 보내는 작업에는 emails:send도 필요합니다: 참석자가 있는 회의의 초대, 업데이트, 취소와 초대에 대한 모든 응답.

일부 주소로 제한된 클라이언트는 그중 한 주소가 주최하거나 참석하는 일정만 보고 바꿀 수 있으며, 그 주소에서만 보냅니다.

레퍼런스

listCalendarEvents

범위calendar:read앱의 어시스턴트가 묻지 않고 실행합니다툴킷calendar

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.

입력

fromstring필수
형식date-time
tostring필수
형식date-time
timezonestring
1~64자
limitinteger
1 이상200 이하
offsetinteger
0 이상

다른 사용처

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

getCalendarEvent

범위calendar:read앱의 어시스턴트가 묻지 않고 실행합니다툴킷calendar

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.

입력

idstring
1~64자
threadIdstring
1~256자

다른 사용처

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

createCalendarEvent

범위calendar:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷calendar

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.

입력

summarystring필수
1~255자
startstring필수
형식date-time
endstring필수
형식date-time
descriptionstring
최대 8000자
locationstring
최대 255자
urlstring
최대 2000자형식uri
allDayboolean
timezonestring
1~64자
recurrencestring
최대 512자
attendeesobject[]
최대 200개 항목
emailstring필수
최대 320자형식email
namestring
최대 128자
optionalboolean
remindersobject[]
최대 5개 항목
minutesBeforeinteger필수
0 이상40320 이하
sendInvitesboolean
fromstring
최대 320자

다른 사용처

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

updateCalendarEvent

범위calendar:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷calendar

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.

입력

idstring필수
1~64자
summarystring
1~255자
startstring
형식date-time
endstring
형식date-time
descriptionstring
최대 8000자
locationstring
최대 255자
urlstring
최대 2000자형식uri
allDayboolean
timezonestring
1~64자
recurrencestring
최대 512자
attendeesobject[]
최대 200개 항목
emailstring필수
최대 320자형식email
namestring
최대 128자
optionalboolean
remindersobject[]
최대 5개 항목
minutesBeforeinteger필수
0 이상40320 이하
sendInvitesboolean
fromstring
최대 320자

다른 사용처

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

cancelCalendarEvent

범위calendar:write앱의 어시스턴트가 항상 먼저 확인합니다툴킷calendar

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.

입력

idstring필수
1~64자
fromstring
최대 320자

다른 사용처

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

deleteCalendarEvent

범위calendar:write앱의 어시스턴트가 항상 먼저 확인합니다툴킷calendar

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.

입력

idstring필수
1~64자

다른 사용처

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

respondToCalendarEvent

범위calendar:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷calendar

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.

입력

idstring필수
1~64자
responsestring필수
다음 중 하나"ACCEPTED""DECLINED""TENTATIVE"
respondingAsstring
최대 320자

다른 사용처

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