Проект интеграции с 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

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

Клонировать репозиторий
git clone https://github.com/Avik-creator/googlecalendarMCP cd googlecalendarMCP
Настроить виртуальную среду
python -m venv venv source venv/bin/activate # On Windows, use `venv\Scripts\activate`
Установить зависимости
pip install -r requirements.txt
Настройка облачной платформы Google
a. Перейдите в Google Cloud Console b. Создайте новый проект или выберите существующий c. Включите API Google Calendar d. Создайте учетные данные OAuth 2.0:
- Перейти к API и службам > Учетные данные
- Нажмите «Создать учетные данные» > «Идентификатор клиента OAuth».
- Выберите «Приложение для настольного компьютера»
- Загрузите файл учетных данных JSON
- Переименуйте его в credentials.json и поместите в корень проекта.
Переменные среды
Создайте файл .env в корне проекта со следующими переменными:
GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json CALENDAR_ID=your_calendar_id@group.calendar.google.com

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

Первая аутентификация
python auth.py
Откроется окно браузера для аутентификации OAuth. Следуйте инструкциям, чтобы авторизовать приложение.
Запуск приложения
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 в безопасности
Регулярно меняйте свои учетные данные и токены