google-mcp

Мультиаккаунтный MCP-сервер Google, предоставляющий инструменты для чтения Gmail и Календаря через stdio.

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

• credentials.json является локальным файлом и его никогда нельзя добавлять в систему контроля версий.

• Скопируйте credentials.template.json в credentials.json и заполните его своими локальными данными OAuth-клиента.

• Токены обновления (refresh tokens) хранятся в системной связке ключей (keyring), а не в системе контроля версий.

Related MCP server: gmail-mcp

Настройка

1. Установите зависимости:

   • uv sync

2. Создайте локальную конфигурацию OAuth-клиента:

   • cp credentials.template.json credentials.json

3. Укажите адреса электронной почты аккаунтов (необязательно, но рекомендуется для проверок безопасности аутентификации):

   • export GOOGLE_MCP_PERSONAL_EMAIL="you@example.com"

   • export GOOGLE_MCP_WORK_EMAIL="you@company.com"

4. При необходимости установите фильтр для конкретного рабочего календаря:

   • export GOOGLE_MCP_WORK_CALENDAR="calendar-id-or-summary"

5. Авторизуйте каждый аккаунт:

   • uv run auth_setup.py personal

   • uv run auth_setup.py work

Запуск сервера

• uv run server.py

Интеграционные тесты

Эти тесты обращаются к реальным API Google.

• Базовые «живые» тесты:

  • RUN_LIVE_TESTS=1 uv run integration_smoke.py

• Включить тест с деструктивным изменением связки ключей:

  • RUN_LIVE_TESTS=1 RUN_DESTRUCTIVE_TESTS=1 uv run integration_smoke.py

Проверки безопасности перед публикацией

• Запуск локального защитного скрипта:

  • python scripts/security_check.py

• Опциональная интеграция с pre-commit:

  • uv tool install pre-commit

  • pre-commit install

  • pre-commit run --all-files

• CI запускает тот же скрипт при каждом push/PR через .github/workflows/security-check.yml.