Проект интеграции с Google Календарем

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

Предпосылки

• Python 3.8 или выше

• Аккаунт Google Cloud Platform

• API Google Календаря включен

• Настроены учетные данные OAuth 2.0

Related MCP server: Google Calendar AutoAuth MCP Server

Инструкции по установке

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

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

npx -y smithery install @Avik-creator/googlecalendarMCP --client claude

Ручная установка

1. Клонировать репозиторий

   git clone https://github.com/Avik-creator/googlecalendarMCP
   cd googlecalendarMCP

2. Настроить виртуальную среду

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. Установить зависимости

   pip install -r requirements.txt

4. Настройка облачной платформы Google

   a. Перейдите в Google Cloud Console b. Создайте новый проект или выберите существующий c. Включите API Google Calendar d. Создайте учетные данные OAuth 2.0:

   • Перейти к API и службам > Учетные данные

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

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

   • Загрузите файл учетных данных JSON

   • Переименуйте его в credentials.json и поместите в корень проекта.

5. Переменные среды

   Создайте файл .env в корне проекта со следующими переменными:

   GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
   CALENDAR_ID=your_calendar_id@group.calendar.google.com

Использование

1. Первая аутентификация

   python auth.py

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

2. Запуск приложения

   python main.py

Функции

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

• Настройте повторяющиеся события

• Управление участниками мероприятия

• Обработка уведомлений и напоминаний о событиях

Структура проекта

googlecalendarMCP/
├── auth.py              # Authentication handling
├── main.py             # Main application entry point
├── requirements.txt    # Project dependencies
├── .env               # Environment variables
├── credentials.json   # Google OAuth credentials
└── token.json        # Generated OAuth token

Зависимости

В проекте используются следующие основные зависимости:

• google-auth-oauthlib

• google-auth-httplib2

• google-api-python-клиент

• python-dotenv

Развернутая конфигурация:

{
  "mcpServers": {
    "google_calendar_mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-google-calendar.avikm744.workers.dev/sse"
      ]
    }
  }
}

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

• Никогда не передавайте файлы credentials.json , token.json или .env в систему контроля версий

• Сохраните свои учетные данные OAuth в безопасности

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

Внося вклад

1. Форк репозитория

2. Создать ветку функций

3. Зафиксируйте ваши изменения

4. Нажмите на ветку

5. Создать запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.