MCP Reference: calendarmcp.googleapis.com

Это MCP-сервер, предоставляемый API Google Calendar. Сервер предоставляет разработчикам инструменты для создания LLM-приложений на основе Calendar.

Сервер протокола контекста модели (MCP) выступает в качестве прокси-сервера между внешним сервисом, предоставляющим контекст, данные или возможности для приложения, использующего большие языковые модели (LLM) или ИИ. Серверы MCP соединяют приложения ИИ с внешними системами, такими как базы данных и веб-сервисы, преобразуя их ответы в формат, понятный приложению ИИ.

Настройка сервера

Перед использованием необходимо настроить сервер Calendar MCP . Дополнительную информацию об использовании удаленных серверов MCP Google и Google Cloud см. в разделе «Обзор серверов MCP Google Cloud» .

Серверные конечные точки

Конечная точка сервиса MCP — это сетевой адрес и интерфейс связи (обычно URL) сервера MCP, который приложение ИИ (хост для клиента MCP) использует для установления безопасного стандартизированного соединения. Это точка контакта для LLM, позволяющая запросить контекст, вызвать инструмент или получить доступ к ресурсу. Конечные точки Google MCP могут быть глобальными или региональными.

Сервер Calendar API MCP имеет следующую глобальную конечную точку MCP:

  • https://calendarmcp.googleapis.com/mcp/v1

Инструменты MCP

Инструмент MCP — это функция или исполняемый файл, который сервер MCP предоставляет приложению LLM или AI для выполнения действий в реальном мире.

Инструменты

Сервер MCP calendarmcp.googleapis.com располагает следующими инструментами:

Инструменты MCP
list_events

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

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

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

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

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

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

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

Пример:

list_events(
    startTime='2024-09-17T06:00:00',
    endTime='2024-09-17T12:00:00',
    pageSize=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.
get_event

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

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

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

Пример:

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

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

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

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

Пример:

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

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

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

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

Пример:

suggest_time(
    attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    startTime='2024-09-10T00:00:00',
    endTime='2024-09-17T00:00:00',
    durationMinutes=60,
    preferences={
        'startHour': '09:00',
        'endHour': '17:00',
        'excludeWeekends': 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.
create_event

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

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

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

Пример:

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

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

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

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

Пример:

update_event(
    eventId='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'.
delete_event

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

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

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

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

Пример:

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

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

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

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

Пример:

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

Получить технические характеристики инструмента MCP

Чтобы получить спецификации всех инструментов MCP на сервере MCP, используйте метод tools/list . В следующем примере показано, как использовать curl для вывода списка всех инструментов и их спецификаций, доступных в данный момент на сервере MCP.

Запрос Curl 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'