google-calendar-mcp-serviceaccount

Минимальный MCP-сервер, который предоставляет ИИ-агенту доступ на чтение и запись к одному календарю Google, аутентифицируясь через сервисный аккаунт, а не через интерактивный OAuth.

Зачем нужен сервисный аккаунт

Большинство MCP-серверов для Google Calendar используют OAuth: приложение просит человека войти в систему и дать согласие, как это сделал бы настоящий многопользовательский продукт. Для личного ассистента, которому нужен доступ только к вашему собственному календарю, это больше церемоний, чем требует задача — публикация в продакшн, проверенные домены, периодическое повторное согласие.

Сервисный аккаунт обходит всё это: вы делитесь своим календарём с адресом электронной почты сервисного аккаунта, точно так же, как поделились бы им с другим человеком. Учётные данные не истекают, пока вы их не отозвёте.

Компромисс: это работает только для календарей, которыми вы можете явно поделиться по электронной почте (личные аккаунты Google, большинство конфигураций Workspace) — он не может действовать широко в рамках аккаунта пользователя, как может полная авторизация OAuth.

Стоимость: на момент написания всё в настройке ниже бесплатно — к проекту Google Cloud не нужно привязывать платёжный аккаунт или кредитную карту. Бесплатная квота Calendar API намного превышает то, что когда-либо будет использовано личным ассистентом. Это может измениться в будущем; при сомнениях проверяйте актуальные цены Google Cloud.

Related MCP server: Google Calendar MCP Server

Инструменты

delete_event намеренно отсутствует — добавьте его самостоятельно, если хотите агента, способного удалять записи календаря.

Настройка

Настраиваете это с помощью ИИ-помощника для написания кода? Укажите ему на AGENTS.md — там вся пошаговая инструкция как для человека, так и для агента.

Вручную:

1. В Google Cloud Console: создайте проект, включите Calendar API, создайте сервисный аккаунт (не OAuth-клиент), скачайте его JSON-ключ

2. Откройте доступ к своему Google Calendar для адреса электронной почты сервисного аккаунта с правом «Make changes to events». Запишите ID календаря: для собственного основного календаря это просто ваш адрес электронной почты; для любого другого календаря найдите его в настройках календаря → «Integrate calendar» → «Calendar ID»

3. python3 -m venv venv && ./venv/bin/pip install -r requirements.txt

4. Скопируйте .env.example в .env и заполните путь к ключу и ID своего календаря

5. Зарегистрируйте calendar_server.py в вашем MCP-клиенте как stdio-сервер, передавая этидие две переменные в качестве его окружения

Лицензия

MIT — см. LICENSE.