# google-calendar

Подключает Google Календарь к ассистенту через сервисный аккаунт Google Workspace. Позволяет просматривать расписание, создавать встречи и проверять занятость.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 81
- Автор: pulsemcp
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/pulsemcp/mcp-servers/tree/HEAD/experimental/google-calendar
- Обновлён: 2026-10-09
- HTML: https://affpapa.org/nevibecode/mcp/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` — тогда ассистент сможет только читать события и проверять статус занятости.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL`, `GCAL_SERVICE_ACCOUNT_PRIVATE_KEY`, `GCAL_IMPERSONATE_EMAIL`, `ENABLED_TOOLGROUPS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: Google Workspace

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить занятость коллег перед назначением звонка
- создать встречу с участниками и описанием в рабочем календаре
- получить список событий на день или неделю с фильтрацией
- обновить время или состав участников существующего события

## Примеры запросов агенту
- Покажи мои встречи на завтра из основного календаря.
- Назначь созвон с colleague@company.com на пятницу в 15:00 на полчаса.
- Проверь, свободен ли я в четверг после обеда.

## Похожие
- [gws-calendar](https://affpapa.org/nevibecode/skills/gws-calendar.md) — скилл · 61200 установок
- [gws-calendar-agenda](https://affpapa.org/nevibecode/skills/gws-calendar-agenda.md) — скилл · 49600 установок
- [calendar-automation](https://affpapa.org/nevibecode/skills/calendar-automation.md) — скилл · 6100 установок
- [Google Workspace](https://affpapa.org/nevibecode/mcp/google-workspace.md) — MCP-сервер · ★ 192
- [google-workspace-cli](https://affpapa.org/nevibecode/skills/hoodini-google-workspace-cli.md) — скилл · 455 установок
- [Google Workspace MCP Server](https://affpapa.org/nevibecode/mcp/google-workspace-mcp-server.md) — MCP-сервер · ★ 12

Из того же набора: [pulsemcp/mcp-servers](https://affpapa.org/nevibecode/by/pulsemcp/mcp-servers.md) — 28 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md