Google Calendar AutoAuth MCP-сервер

Сервер Model Context Protocol (MCP) для интеграции Google Calendar в Claude Desktop с поддержкой автоматической аутентификации. Этот сервер позволяет помощникам ИИ управлять Google Calendar посредством взаимодействия на естественном языке.

Функции

• Создавайте события календаря с названием, описанием, местом и участниками

• Обновите существующие события календаря

• Удалить события календаря

• Получить сведения о событии

• Список событий в указанном диапазоне времени

• Поиск событий по ключевому слову

• Список всех доступных календарей

• Поддержка ввода даты/времени на естественном языке (например, «завтра в 14:00», «следующий понедельник»)

• Полная интеграция с API Календаря Google

• Простой процесс аутентификации OAuth2 с автоматическим запуском браузера

• Поддержка учетных данных как настольных, так и веб-приложений

• Глобальное хранилище учетных данных для удобства

Related MCP server: Google Calendar MCP Server

Установка и аутентификация

Установка через Smithery

Чтобы автоматически установить сервер интеграции Google Calendar для Claude Desktop через Smithery :

Установка вручную

1. Создайте проект Google Cloud и получите учетные данные:

   а. Создайте проект Google Cloud:

   • Перейти в Google Cloud Console

   • Создайте новый проект или выберите существующий

   • Включите API Google Calendar для вашего проекта

   б) Создайте учетные данные OAuth 2.0:

   • Перейдите в раздел «API и службы» > «Учетные данные».

   • Нажмите «Создать учетные данные» > «Идентификатор клиента OAuth».

   • Выберите тип приложения: «Приложение для настольного компьютера» или «Веб-приложение».

   • Дайте ему имя и нажмите «Создать».

   • Для веб-приложения добавьте http://localhost:3000/oauth2callback к разрешенным URI перенаправления.

   • Загрузите JSON-файл ключей OAuth вашего клиента

   • Переименуйте файл ключа в gcp-oauth.keys.json

2. Запустить аутентификацию:

   Аутентификацию можно пройти двумя способами:

   а. Глобальная аутентификация (рекомендуется):

   # First time: Place gcp-oauth.keys.json in your home directory's .calendar-mcp folder mkdir -p ~/.calendar-mcp mv gcp-oauth.keys.json ~/.calendar-mcp/ # Run authentication from anywhere npx @nchufa/calendar auth

   б) Локальная аутентификация:

   # Place gcp-oauth.keys.json in your current directory # The file will be automatically copied to global config npx @nchufa/calendar auth

   Процесс аутентификации будет:

   • Найдите gcp-oauth.keys.json в текущем каталоге или ~/.calendar-mcp/

   • Если файл найден в текущем каталоге, скопируйте его в ~/.calendar-mcp/

   • Откройте браузер по умолчанию для аутентификации Google

   • Сохранить учетные данные как ~/.calendar-mcp/credentials.json

   Примечание :

   • После успешной аутентификации учетные данные сохраняются глобально в ~/.calendar-mcp/ и могут быть использованы из любого каталога.

   • Поддерживаются учетные данные как настольного приложения, так и веб-приложения.

   • Для учетных данных веб-приложения обязательно добавьте http://localhost:3000/oauth2callback к вашим авторизованным URI перенаправления.

3. Настройте в Claude Desktop:

Добавьте следующее в файл конфигурации Claude Desktop:

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

Сервер предоставляет следующие инструменты, которые можно использовать через Claude Desktop:

1. Создать событие ( create_event )

Создает новое событие календаря.

Также поддерживается дата/время на естественном языке:

2. Получить событие ( get_event )

Извлекает сведения о конкретном событии календаря.

3. Обновление события ( update_event )

Обновляет существующее событие календаря.

4. Удалить событие ( delete_event )

Удаляет событие календаря.

5. Список событий ( list_events )

Перечисляет события календаря в указанном диапазоне времени.

6. Поиск событий ( search_events )

Поиск событий, соответствующих запросу.

7. Список календарей ( list_calendars )

Список всех доступных календарей.

Поддержка даты/времени на естественном языке

Сервер поддерживает различные форматы естественного языка для дат и времени:

• Конкретные даты: "2025-04-01T14:00:00" (формат ISO)

• Простые ссылки: «сегодня», «завтра», «сейчас».

• Относительное время: «через 2 часа», «через 3 дня».

• Ссылки на дни: «следующий понедельник», «следующий вторник»

• Комбинированные форматы: «завтра в 14:00», «понедельник в 15:30»

Это позволяет легко создавать и обновлять события с использованием инструкций на естественном языке.

Заметки о безопасности

• Учетные данные OAuth надежно хранятся в вашей локальной среде ( ~/.calendar-mcp/ )

• Сервер использует автономный доступ для поддержания постоянной аутентификации.

• Никогда не передавайте и не передавайте свои учетные данные в систему контроля версий.

• Регулярно проверяйте и отзывайте неиспользуемый доступ в настройках вашего аккаунта Google.

Поиск неисправностей

1. Ключи OAuth не найдены

   • Убедитесь, что gcp-oauth.keys.json находится либо в вашем текущем каталоге, либо в ~/.calendar-mcp/

   • Проверьте права доступа к файлу

2. Неверный формат учетных данных

   • Убедитесь, что ваш файл ключей OAuth содержит web или installed учетные данные.

   • Для веб-приложений проверьте правильность настройки URI перенаправления.

3. Порт уже используется

   • Если порт 3000 уже используется, освободите его перед запуском аутентификации.

   • Вы можете найти и остановить процесс, используя этот порт.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Лицензия

Массачусетский технологический институт

Благодарности

Особая благодарность GongRzhe и его проекту Calendar-Autoauth-MCP-Server , который послужил основой для этой реализации.

Поддерживать

Если у вас возникли какие-либо проблемы или есть вопросы, пожалуйста, сообщите о проблеме в репозитории GitHub.