Google Calendar MCP сервер

Сервер Model Context Protocol (MCP), который обеспечивает интеграцию с Google Calendar для AI-ассистентов, позволяя управлять календарем, создавать события, помогать с планированием и интеллектуально импортировать данные из изображений и документов.

Установка

NPX

npx @cocal/google-calendar-mcp

Из исходников

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

Конфигурация

Claude Desktop

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

Доступные инструменты

Инструмент	Описание
`list-calendars`	Показать все доступные календари
`list-events`	Показать события с фильтрацией по дате
`search-events`	Поиск событий по текстовому запросу
`create-event`	Создать новые события в календаре
`update-event`	Обновить существующие события
`delete-event`	Удалить события
`get-freebusy`	Проверить доступность в календарях, включая внешние календари
`list-colors`	Показать доступные цвета для событий

Возможности

Поддержка нескольких календарей: Просматривайте события из нескольких календарей одновременно
Управление событиями: Создавайте, обновляйте, удаляйте и ищите события календаря
Повторяющиеся события: Расширенные возможности изменения повторяющихся событий
Запросы занятости/свободы: Проверяйте доступность в календарях
Умное планирование: Понимание дат и времени на естественном языке
Интеллектуальный импорт: Добавляйте события календаря из изображений, PDF или веб-ссылок

Переменные окружения

Обязательные

GOOGLE_OAUTH_CREDENTIALS - Путь к файлу OAuth учетных данных

Опциональные

GOOGLE_CALENDAR_MCP_TOKEN_PATH - Пользовательское расположение хранения токенов

Примеры использования

Пожалуйста, покажи доступность, просмотрев мой личный и рабочий календарь на эту неделю. Я ищу подходящее время для встречи с кем-то в Лондоне на 1 час.

Добавь это событие в мой календарь на основе прикрепленного скриншота.

Какие события у меня на этой неделе, которые не являются частью моей обычной рутины?

Какие события завтра имеют участников, которые не приняли приглашение?

Вот некоторая доступность, которая была мне предоставлена. {доступное время} Посмотри на предоставленное время и дай мне знать, какое из них свободно в моем календаре.

Ресурсы

GitHub Repository

Примечания

Требует проект Google Cloud с включенным Calendar API и учетными данными OAuth 2.0 (тип Desktop app). Поддерживает аутентификацию через браузерный OAuth поток. Токены в тестовом режиме истекают через 7 дней. Поддерживает форматы изображений: PNG, JPEG, GIF для интеллектуального импорта событий.