Outlook-Mail-MCP

Минималистичный почтовый MCP для домашней машины: подключите один Outlook-ящик, читайте письма и отвечайте на них.

🤝 Совместно создано Lynn & Sage (ChatGPT)

Этот проект был спроектирован, реализован и отлажен совместно Lynn и Sage (ChatGPT).

Этот проект делает только три вещи:

• 📬 Просмотр последних писем

• 📖 Чтение писем

• ↩️ Ответ на письма

Никакого календаря, никакого облачного хранилища, никакого Power Automate и никакого управления несколькими аккаунтами.

Вариант развертывания

Этот вариант использует Render Web Service + Microsoft Outlook / Microsoft Graph + OAuth 2.0 в качестве основного способа развертывания и подходит для предоставления почтовых возможностей домашней машине в виде удаленного MCP-сервиса.

Его также можно запускать в любой среде, поддерживающей Node.js, HTTPS и постоянное хранение токенов, но конфигурация по умолчанию и файлы развертывания ориентированы на Render.

Related MCP server: outlook-mcp

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

После развертывания на Render откройте главную страницу сервиса, нажмите Подключить почтовый ящик Outlook и завершите вход и авторизацию Microsoft.

После завершения авторизации подключите MCP-адрес https://你的服务地址/mcp к домашней машине.

Настройка Microsoft

Создайте приложение в Microsoft Entra / Azure App Registration и включите следующие делегированные разрешения (Delegated permissions):

• openid

• profile

• offline_access

• User.Read

• Mail.Read

• Mail.ReadWrite

• Mail.Send

Используйте Redirect URI:

https://你的服务地址/auth/callback

Выберите тип приложения Web.

Переменные окружения

MS_CLIENT_ID=你的 Application (client) ID
MS_CLIENT_SECRET=你的 Client Secret VALUE
MS_TENANT_ID=common
TOKEN_DIR=/data

На Render сервер сначала использует PUBLIC_URL, в противном случае — автоматически предоставляемый Render RENDER_EXTERNAL_URL, для формирования адреса OAuth-обратного вызова.

Развертывание на Render

Репозиторий уже содержит render.yaml, поэтому можно развернуть напрямую с помощью Render Blueprint.

Конфигурация Render включает:

• Node.js Web Service

• /health проверка состояния

• 1 ГБ постоянного диска

• /data каталог хранения токенов

• переменные окружения, необходимые для Microsoft OAuth

Токены хранятся на постоянном диске Render и не попадают в GitHub.

MCP-инструменты

Локальный запуск

npm install
npm start

Адрес по умолчанию: http://localhost:3000/.

Локальный OAuth-обратный вызов: http://localhost:3000/auth/callback.

Безопасность

Пароль OAuth не передается домашней машине. После завершения входа в Microsoft сервис сохраняет только OAuth-токен; права на файл токена установлены так, что читать и записывать его может только пользователь текущего процесса.

Благодарности

Lynn × Sage（ChatGPT）
Один человек-разработчик + один ИИ-напарник вместе собрали этот маленький инструмент. 🫳