google-calendar — MCP-сервер для Claude Code: установка
Подключает Google Календарь к ассистенту через сервисный аккаунт Google Workspace. Позволяет просматривать расписание, создавать встречи и проверять занятость.
claude mcp add --env GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GCAL_SERVICE_ACCOUNT_PRIVATE_KEY=<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY> --env GCAL_IMPERSONATE_EMAIL=<GCAL_IMPERSONATE_EMAIL> --env ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> --transport stdio google-calendar -- npx -y google-calendar-workspace-mcp-serverЧто делает google-calendar
Сервер транслирует запросы модели в вызовы Google Calendar API, используя делегирование полномочий на уровне домена (domain-wide delegation). Ассистент работает от имени конкретного пользователя, чей адрес указан в переменной GCAL_IMPERSONATE_EMAIL. Доступны просмотр событий, создание встреч с участниками, частичное обновление через PATCH и поиск свободных слотов.
Для запуска обычного аккаунта Gmail недостаточно: требуется Google Cloud проект с включённым Calendar API и административный доступ к Google Workspace. Без подтверждённого Client ID и скоупа https://www.googleapis.com/auth/calendar в консоли Workspace авторизация завершится ошибкой.
По умолчанию включены все 7 инструментов. Если нужно запретить редактирование календаря, задайте переменную ENABLED_TOOLGROUPS=readonly — тогда ассистент сможет только читать события и проверять статус занятости.
Какие задачи решает
- проверить занятость коллег перед назначением звонка
- создать встречу с участниками и описанием в рабочем календаре
- получить список событий на день или неделю с фильтрацией
- обновить время или состав участников существующего события
Примеры запросов агенту
- Покажи мои встречи на завтра из основного календаря.
- Назначь созвон с [email protected] на пятницу в 15:00 на полчаса.
- Проверь, свободен ли я в четверг после обеда.
Как установить google-calendar
Командой платформы
claude mcp add --env GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GCAL_SERVICE_ACCOUNT_PRIVATE_KEY=<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY> --env GCAL_IMPERSONATE_EMAIL=<GCAL_IMPERSONATE_EMAIL> --env ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> --transport stdio google-calendar -- npx -y google-calendar-workspace-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add google-calendar --env GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GCAL_SERVICE_ACCOUNT_PRIVATE_KEY=<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY> --env GCAL_IMPERSONATE_EMAIL=<GCAL_IMPERSONATE_EMAIL> --env ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> -- npx -y google-calendar-workspace-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"google-calendar": {
"command": "npx",
"args": [
"-y",
"google-calendar-workspace-mcp-server"
],
"env": {
"GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
"GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>",
"GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>",
"ENABLED_TOOLGROUPS": "<ENABLED_TOOLGROUPS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"google-calendar": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-calendar-workspace-mcp-server"
],
"env": {
"GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
"GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>",
"GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>",
"ENABLED_TOOLGROUPS": "<ENABLED_TOOLGROUPS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL> -e GCAL_SERVICE_ACCOUNT_PRIVATE_KEY=<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY> -e GCAL_IMPERSONATE_EMAIL=<GCAL_IMPERSONATE_EMAIL> -e ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> google-calendar npx -y google-calendar-workspace-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о google-calendar
Как установить google-calendar в Claude Code?
Выполните команду: `claude mcp add google-calendar -e GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL> -e GCAL_SERVICE_ACCOUNT_PRIVATE_KEY=<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY> -e GCAL_IMPERSONATE_EMAIL=<GCAL_IMPERSONATE_EMAIL> -- npx -y google-calendar-workspace-mcp-server`. Замените плейсхолдеры на параметры сервисного аккаунта и рабочий email.
Что делает этот MCP-сервер?
Он даёт ИИ-ассистенту доступ к корпоративному Google Календарю через API: позволяет искать свободные слоты, читать расписание и создавать записи без перехода в браузер.
Можно ли ограничить сервер только чтением?
Да, для этого задайте переменную окружения ENABLED_TOOLGROUPS=readonly. В таком режиме функции создания, изменения и удаления встреч будут отключены.
