google-calendar-mcp-serviceaccount
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
Инструменты
Инструмент | Назначение |
| Список предстоящих событий на ближайшие N дней |
| Создание события, возможно повторяющегося (RRULE) |
| Обновление названия или времени существующего события |
delete_event намеренно отсутствует — добавьте его самостоятельно, если хотите агента, способного удалять записи календаря.
Настройка
Настраиваете это с помощью ИИ-помощника для написания кода? Укажите ему на AGENTS.md — там вся пошаговая инструкция как для человека, так и для агента.
Вручную:
В Google Cloud Console: создайте проект, включите Calendar API, создайте сервисный аккаунт (не OAuth-клиент), скачайте его JSON-ключ
Откройте доступ к своему Google Calendar для адреса электронной почты сервисного аккаунта с правом «Make changes to events». Запишите ID календаря: для собственного основного календаря это просто ваш адрес электронной почты; для любого другого календаря найдите его в настройках календаря → «Integrate calendar» → «Calendar ID»
python3 -m venv venv && ./venv/bin/pip install -r requirements.txtСкопируйте
.env.exampleв.envи заполните путь к ключу и ID своего календаряЗарегистрируйте
calendar_server.pyв вашем MCP-клиенте как stdio-сервер, передавая этидие две переменные в качестве его окружения
Лицензия
MIT — см. LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Agent-Native Google Calendar - manage events, sync, and public booking
Scheduling infrastructure for AI agents across Google and Microsoft calendars.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI assistants to interact with Google Calendar through a simplified OAuth setup. Supports creating, editing, deleting, and searching calendar events without the complexity of Google Cloud Console configuration.422 npm4MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Google Calendar through OAuth 2.1 authentication, supporting full calendar and event management including creation, updates, deletion, and search across multiple calendars.1MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to create and manage Google Calendar events with OAuth2 authentication, supporting event creation with titles, descriptions, times, attendees, and alerts.113 npm3MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to view, create, update, search, and manage Google Calendar events, including multi-account support and availability checks.17 npmBusiness Source 1.1