gmail-read-mcp

Сервер MCP для чтения Gmail, ограниченный одним почтовым ящиком. Предоставляет два инструмента через stdio:

• list_emails — список писем, полученных за указанный период: метаданные + фрагмент, от старых к новым (максимум 500)

• read_email — чтение полных заголовков и текста одного письма по идентификатору

Нет возможностей записи, отправки, маркировки или удаления. Каждый результат содержит глубокую ссылку jump_url (поиск rfc822msgid:), которая открывает письмо для любого, кто вошёл в почтовый ящик. Письма, отправленные с самого почтового ящика (ответы команды), по умолчанию исключаются; спам и корзина всегда исключаются.

Настройка Google OAuth

1. Создайте проект Google Cloud (отдельный от любого производственного проекта — экран согласия привязан к проекту) и включите Gmail API.

2. Установите экран согласия OAuth в значение Internal (пропускает проверку ограниченных областей для области gmail.readonly).

3. Создайте OAuth-клиент типа Desktop app и скачайте JSON-файл клиента.

4. Выполните одноразовый процесс согласия, войдя как целевой почтовый ящик:

node scripts/gmail-oauth-once.mjs <path-to-client-secret.json>

Он выводит refresh-токен и почтовый ящик, к которому он привязан.

Refresh-токен не имеет срока действия, но Google отзывает токены с областью Gmail при смене пароля учётной записи. Если сервер начинает выдавать ошибку invalid_grant, повторите шаг 4 и замените GMAIL_REFRESH_TOKEN.

Related MCP server: Gmail MCP Server

Локальная настройка

cp .env.example .env
# Fill in GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET, GMAIL_REFRESH_TOKEN
npm install
npm start

Тестирование

npm test