MCP Headless Gmail Server
Обеспечивает headless доступ к Gmail для чтения и отправки писем без локальной настройки токенов.
Описание
Это MCP-сервер на Python для работы с Gmail в headless-режиме, без браузера и локальных файлов. Поддерживает контейнеризацию в Docker, использует google-api-python-client. Ключевые особенности: получение недавних email с фрагментами тела, чтение полных сообщений по частям, отправка писем, обновление токенов. Идеален для автоматизации в маркетинге, удаленных средах, где нужна изоляция учетных данных OAuth.
Возможности
Получение недавних email
Извлекает последние письма с первыми 1000 символами тела, метаданными и индикатором полной загрузки.
Чтение полного тела email
Загружает тело сообщения по частям (1k чанков) с использованием offset или thread ID.
Отправка email
Отправляет письма через Gmail с поддержкой текста и HTML-тела.
Обновление токенов
Отдельный инструмент для refresh access token с использованием refresh token и client credentials.
Автоматическое обновление токенов
Автоматическая обработка истечения токенов без вмешательства пользователя.
Установка
Установка:
Клонирование и установка зависимостей
git clone https://github.com/baryhuang/mcp-headless-gmail.git cd mcp-headless-gmail pip install -e .
Docker сборка
docker build -t mcp-headless-gmail .
Конфигурация для Claude Desktop (Docker)
{ “mcpServers”: { “gmail”: { “command”: “docker”, “args”: [ “run”, “-i”, “–rm”, “buryhuang/mcp-headless-gmail:latest” ] } } }
NPM версия
{ “mcpServers”: { “gmail”: { “command”: “npx”, “args”: [ “@peakmojo/mcp-server-headless-gmail” ] } } }
Требования: Python 3.10+, Google API credentials (client ID, secret, tokens).