MCP Reference: calendarmcp.googleapis.com

Выводит список событий календаря, удовлетворяющих заданным условиям.

Основные характеристики:

• Любой идентификатор календаря, который может соответствовать основному календарю пользователя или другим.
• Сопоставление ключевых слов.
• Фильтрация по временному диапазону.
• Извлекает ВСЕ события, соответствующие временным и ключевым ограничениям.

Используйте инструмент search_events, если:

• Вам необходимо найти (K наиболее релевантных) событий, а не все события, удовлетворяющие ограничениям.
• Вам необходимы возможности семантического поиска.
• Вы выполняете поиск конкретной информации только в основном календаре пользователя.

Используйте этот инструмент для таких запросов, как:

• Что у меня на завтра в календаре?
• Что запланировано у меня на 14 июля 2025 года?
• Какие у меня встречи на следующей неделе?
• Есть ли у меня какие-либо дела сегодня днем?

Пример:

list_events(
    start_time='2024-09-17T06:00:00',
    end_time='2024-09-17T12:00:00',
    page_size=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.

Возвращает одно событие из заданного календаря.

Используйте этот инструмент для таких запросов, как:

• Получите подробную информацию о командном собрании.
• Отобразите в моем календаре событие с идентификатором event123.

Пример:

get_event(
    event_id='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.

Возвращает календари из списка календарей пользователя.

Используйте этот инструмент для таких запросов, как:

• Что представляют собой все мои календари?

Пример:

list_calendars()
# Returns all calendars the authenticated user has access to.

Предлагает временные периоды для одного или нескольких календарей. Чтобы получить доступ к основному календарю, добавьте «primary» в поле attendee_emails.

Используйте этот инструмент для таких запросов, как:

• Когда мы все сможем собраться на встречу?
• Найдите 30-минутное время, когда мы оба будем свободны.
• Проверьте, свободен ли адрес jane.doe@google.com в понедельник утром.

Пример:

suggest_time(
    attendee_emails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    start_time='2024-09-10T00:00:00',
    end_time='2024-09-17T00:00:00',
    duration_minutes=60,
    preferences={
        'start_hour': '09:00',
        'end_hour': '17:00',
        'exclude_weekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.

Создает событие в календаре.

Используйте этот инструмент для таких запросов, как:

• Создать в моем календаре событие на завтра в 14:00 под названием «Встреча с Джейн».
• Назначьте встречу с john.doe@google.com в следующий понедельник с 10:00 до 11:00.

Пример:

create_event(
    summary='Meeting with Jane',
    start_time='2024-09-17T14:00:00',
    end_time='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.

Обновляет событие в календаре.

Используйте этот инструмент для таких запросов, как:

• Перенесите событие «Встреча с Джейн» на один час позже.
• Добавьте john.doe@google.com в список участников завтрашней встречи.

Пример:

update_event(
    event_id='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.

Удаляет событие календаря.

Используйте этот инструмент для таких запросов, как:

• Удалить событие с идентификатором event123 из моего календаря.

Для отмены или отклонения события используйте инструмент respond_to_event.

Пример:

delete_event(
    event_id='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.

Реагирует на событие.

Используйте этот инструмент для таких запросов, как:

• Принять событие с идентификатором event123 в моём календаре.
• Откажитесь от встречи с Джейн.
• Отмените мою следующую встречу.
• Предварительно соглашаюсь на проведение совещания по планированию.

Пример:

respond_to_event(
    event_id='event123',
    response_status='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.