Google Calendar MCP Server

Что умеет сервер

Сервер работает с несколькими аккаунтами Google и календарями сразу. Он умеет перечислять события из нескольких календарей одним запросом, находить пересечения между календарями разных аккаунтов, создавать, менять, удалять и искать события, изменять повторяющиеся события, проверять занятость (free/busy). Автор отмечает понимание дат и времени на естественном языке и «умный импорт»: событие можно добавить по картинке, PDF или ссылке.

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

Когда использовать

Сервер пригодится, когда ассистент должен подобрать время для встречи по личному и рабочему календарям, поставить событие из скриншота или перенести серию встреч. Автор отдельно упоминает размещаемое решение без Google Cloud, но это отдельный продукт; сам сервер требует собственный проект.

Ограничения и безопасность

Для работы нужны проект Google Cloud с включённым Calendar API и учётные данные OAuth 2.0 типа Desktop app. Пока приложение в тестовом режиме, токены доступа живут около недели, и вход нужно повторять. Чтобы этого избежать, приложение переводят в рабочий режим без проверки Google, но тогда Google показывает предупреждение о непроверенном приложении.

Перед первым использованием попросите клиента пройти аутентификацию в Google Calendar, иначе запросы завершатся ошибкой. Альтернатива OAuth: сервисный аккаунт. Он не истекает, но видит только календари, которыми с ним поделились, не может приглашать участников без делегирования на уровне домена и не показывает список календарей. Ключ сервисного аккаунта — учётные данные без срока действия, храните его вне репозитория.

Claude Desktop (npx)

Добавьте блок в claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }
  }
}

При запуске через npx путь к файлу учётных данных нужно задавать именно переменной GOOGLE_OAUTH_CREDENTIALS.

Локальная установка

git clone https://github.com/nspady/google-calendar-mcp.git
cd google-calendar-mcp
npm install
npm run build

Docker

git clone https://github.com/nspady/google-calendar-mcp.git
cd google-calendar-mcp
cp /path/to/your/gcp-oauth.keys.json .
docker compose up

Первый запуск

1. Запустите Claude Desktop (в Claude Code шаги те же).
2. Попросите ассистента пройти аутентификацию в Google Calendar.
3. Завершите вход в браузере.

Повторная аутентификация, если токен истёк:

export GOOGLE_OAUTH_CREDENTIALS="/path/to/your/gcp-oauth.keys.json"
npx @cocal/google-calendar-mcp auth

Для локальной установки: npm run auth.