Google Calendar AutoAuth MCP Server

Google Calendar AutoAuth MCP-сервер

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

Функции

• Создавайте события календаря с названием, описанием, местом и участниками
• Обновите существующие события календаря
• Удалить события календаря
• Получить сведения о событии
• Список событий в указанном диапазоне времени
• Поиск событий по ключевому слову
• Список всех доступных календарей
• Поддержка ввода даты/времени на естественном языке (например, «завтра в 14:00», «следующий понедельник»)
• Полная интеграция с API Календаря Google
• Простой процесс аутентификации OAuth2 с автоматическим запуском браузера
• Поддержка учетных данных как настольных, так и веб-приложений
• Глобальное хранилище учетных данных для удобства

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

Установка через 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.