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

Google Calendar offers a remote Model Context Protocol (MCP) server that lets AI agents securely interact with Calendar data. By configuring the Calendar MCP server, you enable AI applications such as Google Antigravity and Claude to perform actions in Calendar.

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

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

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

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

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

Включите API

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

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

CLI 

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

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

Консоль

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

Включите API

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

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

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

CLI 

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

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

Консоль

Включите службы MCP в консоли:

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

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

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

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

  2. If you already configured the Google Auth Platform , you can configure the following OAuth consent screen settings in Branding , Audience , and Data Access . If you see a message that says Google Auth Platform not configured yet , click Get Started :

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

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

    1. В разделе «Добавить области действия вручную» вставьте области действия для сервера 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.

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

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

To add the Calendar remote MCP server to Antigravity, add the server configuration to your mcp_config.json file. These instructions support Antigravity 2.0, Antigravity IDE, and Antigravity CLI.

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

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

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

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

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

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

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

  2. Откройте или создайте конфигурационный файл ~/.gemini/config/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. Use the arrow keys to select calendar , move to the Authenticate action, and press Enter . Complete the sign-in flow in your browser, copy the authorization code, paste it into the terminal prompt, and press Enter .

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

    • Для Antigravity IDE или GUI: кнопка «Выход» отображается рядом с сервером в разделе «Настройки» > «Установленные серверы MCP» .
    • For Antigravity CLI: Open the /mcp panel to view your configured MCP servers. Verified and authenticated servers display Authed next to their names inside the interactive TUI panel. You can select the server under the dashboard view to inspect its status and list all of its available tools.

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

Клод

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

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

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

    1. В консоли перейдите в 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. Введите данные для подключения к продукту «Календарь»:
      • Имя сервера : Calendar .
      • URL удаленного MCP-сервера : https://calendarmcp.googleapis.com/mcp/v1
    4. В разделе «Расширенные настройки» введите идентификатор клиента OAuth и секретный ключ клиента OAuth .
    5. Нажмите «Добавить» .

Другие

Many AI applications have ways to connect to a remote MCP server. You typically need to enter details about the server, such as its name, endpoints, transport protocol, and authentication method. For the Calendar remote MCP server, enter the following:

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

Проверьте работу сервера Calendar MCP.

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

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

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

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

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

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

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

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

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

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

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

When you expose a language model to untrusted data, there is a risk of an indirect prompt injection attack . Because MCP hosts such as Google Antigravity have access to powerful tools and APIs through the Calendar MCP server, they can read, modify, and delete data in your Google Account.

To mitigate these risks, you must screen prompts and responses for malicious content or prompt injection attacks. You can use the Google-provided Model Armor or you can use your own solution if you document it in order for users to accept that risk. For more information, see Configure security for Google Workspace MCP servers .

Следуйте этим рекомендациям:

  • Используйте только проверенные инструменты. Никогда не подключайте сервер Calendar MCP к ненадежным или непроверенным приложениям.
  • Be cautious with untrusted inputs. Avoid asking your MCP client to process events or other resources from unverified sources. These inputs may contain hidden instructions that can hijack your session, allowing an attacker to modify, steal, or delete your data.
  • Проверяйте все действия. Всегда внимательно проверяйте действия, выполняемые вашим ИИ-клиентом от вашего имени, чтобы убедиться в их правильности и соответствии вашим намерениям.