Настройте сервер Calendar MCP.

Google Календарь предоставляет удаленный сервер протокола контекста модели (MCP) , который позволяет агентам искусственного интеллекта безопасно взаимодействовать с данными Google Календаря. Настроив сервер MCP Google Календаря, вы позволяете таким приложениям ИИ, как Google Antigravity и Claude, выполнять действия в Google Календаре.

Сервер Google Calendar MCP предоставляет стандартизированный способ для агентов искусственного интеллекта:

  • Чтение данных : отображение календарей, получение событий и проверка доступности.
  • Примите меры : создавайте, обновляйте и удаляйте события.
  • Соблюдайте правила безопасности : наследуйте те же права доступа и средства управления данными, что и пользователь.

Предварительные требования

Настройте сервер Google Календа MCP.

Для использования сервера Google Calendar MCP необходимо включить его в вашем проекте Google Cloud, а затем настроить клиент MCP для подключения к нему.

Включите API

Для использования сервера Google Calendar MCP необходимо включить следующий API в вашем проекте Google Cloud:

  • API календаря Google

CLI 

gcloud services enable calendar-json.googleapis.com --project=PROJECT_ID

Замените PROJECT_ID на идентификатор вашего проекта в Google Cloud.

Консоль

Включите API в консоли Google Cloud:

Включите API

Включите службы MCP.

Для включения компонентов MCP для Google Календаря необходимо активировать следующую службу в вашем проекте Google Cloud:

  • Google Календарь MCP API

CLI 

gcloud services enable calendarmcp.googleapis.com --project=PROJECT_ID

Замените PROJECT_ID на идентификатор вашего проекта в Google Cloud.

Консоль

Включите сервисы MCP в консоли Google Cloud:

Включите службы MCP.

Сервер Google Calendar MCP использует OAuth 2.0 для аутентификации и авторизации. Перед созданием идентификатора клиента OAuth необходимо настроить экран согласия OAuth.

  1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Брендинг .

    Перейти к разделу «Брендинг»

  2. Если вы уже настроили платформу аутентификации Google , вы можете настроить следующие параметры экрана согласия OAuth в разделах «Брендинг» , «Аудитория» и «Доступ к данным» . Если вы видите сообщение о том, что платформа аутентификации Google еще не настроена , нажмите «Начать» :

    1. В разделе «Информация о приложении» в поле «Название приложения» введите Calendar MCP Server .
    2. В разделе «Электронная почта службы поддержки пользователей» выберите свой адрес электронной почты или соответствующую группу Google.
    3. Нажмите «Далее» .
    4. В разделе «Аудитория» выберите «Внутренняя» . Если выбрать «Внутренняя» невозможно, выберите «Внешняя» .
    5. Нажмите «Далее» .
    6. В поле «Контактная информация» укажите адрес электронной почты , на который вы сможете получать уведомления об изменениях в вашем проекте.
    7. Нажмите «Далее» .
    8. В разделе «Завершить» ознакомьтесь с Политикой использования пользовательских данных сервисов Google API и, если вы согласны, выберите «Я согласен с Политикой использования пользовательских данных сервисов Google API» .
    9. Нажмите «Продолжить» .
    10. Нажмите «Создать» .
    11. Если для типа пользователя выбран «Внешний» , добавьте тестовых пользователей:
      1. Нажмите «Аудитория» .
      2. В разделе «Проверка пользователей» нажмите «Добавить пользователей» .
      3. Введите свой адрес электронной почты и имена других авторизованных пользователей, участвующих в тестировании, затем нажмите «Сохранить» .

  3. Нажмите «Доступ к данным» > «Добавить или удалить области действия ». Откроется панель со списком областей действия для каждого API, который вы включили в своем проекте Google Cloud.

    1. В разделе «Добавить области действия вручную» вставьте области действия для сервера Google Calendar MCP:

      • https://www.googleapis.com/auth/calendar.calendarlist.readonly
      • https://www.googleapis.com/auth/calendar.events.freebusy
      • https://www.googleapis.com/auth/calendar.events.readonly

    2. Нажмите «Добавить в таблицу» .

    3. Нажмите «Обновить» .

    4. После выбора областей доступа, необходимых для вашего приложения, на странице «Доступ к данным» нажмите «Сохранить» .

Настройте свой клиент MCP.

Чтобы добавить удаленный сервер Google Calendar MCP в ваш клиент MCP, следуйте инструкциям для вашего клиента.

Антигравитация

Чтобы добавить удаленный сервер Google Calendar MCP в Antigravity, добавьте конфигурацию сервера в файл mcp_config.json . Эти инструкции поддерживают Antigravity 2.0, Antigravity IDE и Antigravity CLI.

  1. Создайте идентификатор клиента и секретный ключ OAuth 2.0:

    1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент

      Перейдите в раздел «Создать клиента».

    2. В качестве типа приложения выберите «Веб-приложение» .

    3. Введите имя .

    4. В разделе «Авторизованные URI перенаправления» нажмите « + Добавить URI» , а затем в поле «URI» добавьте https://antigravity.google/oauth-callback .

    5. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

  2. Откройте или создайте конфигурационный файл ~/.gemini/antigravity/mcp_config.json .

  3. Добавьте конфигурацию mcpServers в mcp_config.json :

    {
  "mcpServers": {
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Замените следующее:

    • OAUTH_CLIENT_ID : Идентификатор клиента, который вы создали.
    • OAUTH_CLIENT_SECRET : Созданный вами секретный ключ клиента.

  4. Сохраните mcp_config.json .

  5. Выполните аутентификацию на сервере MCP. Аутентификацию можно выполнить либо через графический интерфейс, либо через командную строку:

    • Для Antigravity IDE или GUI (Antigravity 2.0):

      1. Откройте экран настроек (например, нажмите «Настройки» в левом нижнем углу или откройте «Пользовательские настройки Antigravity »).
      2. Перейдите в раздел «Настройки» .
      3. В разделе «Установленные серверы MCP» нажмите «Обновить» .
      4. Найдите calendar в списке, нажмите «Аутентифицировать» , войдите в свой аккаунт Google, скопируйте код авторизации, вставьте его в диалоговое окно ввода и нажмите «Отправить» .

    • Для интерфейса командной строки Antigravity:

      1. Запуск интерфейса командной строки Antigravity:

        agy

      2. Откройте интерактивную панель управления MCP, выполнив следующую команду:

        /mcp

      3. С помощью клавиш со стрелками выберите calendar , перейдите к действию «Аутентификация» и нажмите Enter . Завершите процесс входа в систему в браузере, скопируйте код авторизации, вставьте его в командную строку терминала и нажмите Enter .

  6. Убедитесь, что сервер правильно настроен и запущен:

    • Для Antigravity IDE или GUI: кнопка «Выход» отображается рядом с сервером в разделе «Настройки» > «Установленные серверы MCP» .
    • Для Antigravity CLI: Откройте панель /mcp , чтобы просмотреть настроенные серверы MCP. Проверенные и аутентифицированные серверы отображаются с пометкой «Authented» рядом со своими именами в интерактивной панели TUI. Вы можете выбрать сервер на панели управления, чтобы проверить его статус и просмотреть список всех доступных инструментов.

Удаленный MCP-сервер готов к использованию в Antigravity.

Клод

Для использования удаленного сервера Google Calendar MCP с Claude.ai или Claude Desktop вам необходим тарифный план Claude Enterprise, Pro, Max или Team.

Чтобы добавить удаленный сервер Google Calendar MCP в Claude, настройте пользовательский коннектор с идентификатором клиента OAuth и секретным ключом.

  1. Создайте идентификатор клиента и секретный ключ OAuth 2.0:

    1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Клиенты > Создать клиент

      Перейдите в раздел «Создать клиента».

    2. В качестве типа приложения выберите «Веб-приложение» .

    3. Введите имя .

    4. В разделе «Авторизованные URI перенаправления» нажмите « + Добавить URI» , а затем в поле «URI» добавьте https://claude.ai/api/mcp/auth_callback .

    5. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret) .

  2. Настройте сервер MCP в Claude:

    1. В Claude.ai или Claude Desktop перейдите в Настройки (или Административные настройки ) > Коннекторы .
    2. Нажмите « Добавить пользовательский коннектор» .
    3. Введите данные для подключения к продукту Google Календарь:
      • Имя сервера : Google Calendar .
      • URL удаленного MCP-сервера : https://calendarmcp.googleapis.com/mcp/v1
    4. В разделе «Расширенные настройки» введите идентификатор клиента OAuth и секретный ключ клиента OAuth .
    5. Нажмите «Добавить» .

Другие

Многие приложения искусственного интеллекта позволяют подключаться к удалённому серверу MCP. Обычно для этого требуется ввести данные о сервере, такие как его имя, конечные точки, транспортный протокол и метод аутентификации. Для удалённого сервера MCP Google Calendar введите следующее:

Для получения более подробной информации о подключении различных типов клиентов см. раздел «Настройка MCP в приложении ИИ» .

Проверьте работу сервера Google Календаря MCP.

После настройки клиента MCP вы можете проверить соединение, запустив несколько тестовых запросов.

Попробуйте задать своему клиенту MCP следующие вопросы:

  • «Когда состоится моя следующая встреча с Ариэлем?»

    Клиент проверяет ваше расписание с помощью calendar.list_events и указывает подробности вашей следующей встречи с Ариэлем.

Если инструменты работают успешно и вы получаете соответствующие ответы, значит, ваш сервер Google Calendar MCP настроен правильно.

Поиск неисправностей

Если у вас возникли проблемы с подключением к серверу MCP, вы можете проверить наличие ошибок в журналах OAuth. Попросите вашего администратора проверить события журнала OAuth в инструменте анализа безопасности .

Справочник инструментов

Для сервера Google Календарь MCP доступны следующие инструменты:

  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • suggest_time
  • update_event

Важный аспект безопасности: непрямая инъекция подсказки.

Когда вы предоставляете языковой модели доступ к ненадежным данным, существует риск косвенной атаки с внедрением подсказок . Поскольку клиенты MCP, такие как Google Antigravity, имеют доступ к мощным инструментам и API через сервер Google Calendar MCP, они могут читать, изменять и удалять данные в вашей учетной записи Google.

Для снижения этих рисков следуйте этим передовым методам:

  • Используйте только проверенные инструменты. Никогда не подключайте сервер Google Calendar MCP к ненадежным или непроверенным приложениям.
  • Будьте осторожны с ненадежными входными данными. Избегайте запросов к вашему MCP-клиенту на обработку событий или других ресурсов из непроверенных источников. Эти входные данные могут содержать скрытые инструкции, которые могут перехватить вашу сессию, позволяя злоумышленнику изменить, украсть или удалить ваши данные.
  • Проверяйте все действия. Всегда внимательно проверяйте действия, выполняемые вашим ИИ-клиентом от вашего имени, чтобы убедиться в их правильности и соответствии вашим намерениям.