Microsoft 365 Mail — MCP-сервер для Claude Code: как установить
MCP-сервер подключает рабочую почту Outlook через Microsoft Graph. Помогает агенту читать цепочки писем, отвечать на сообщения и раскладывать переписку по папкам.
claude mcp add --env MS_CLIENT_ID=<MS_CLIENT_ID> --env MS_CONFIG_DIR=<MS_CONFIG_DIR> --env MS_ACCOUNT_EMAIL=<MS_ACCOUNT_EMAIL> --env MS_MCP_PACKAGE_ID=<MS_MCP_PACKAGE_ID> --env MICROSOFT_REQUEST_TIMEOUT_MS=<MICROSOFT_REQUEST_TIMEOUT_MS> --transport stdio microsoft-mail -- npx -y @mindstone/mcp-server-microsoft-mailЧто делает Microsoft 365 Mail
Сервер даёт агенту 22 инструмента для взаимодействия с Outlook Mail через Graph API. Доступны поиск сообщений, чтение цепочек, подготовка черновиков и настройка автоответов. В этот коннектор также встроен инструмент authenticate_microsoft_account. Его сессии подходят для всей связки сервисов Microsoft 365.
Главная особенность архитектуры — сервер не запускает собственный OAuth-поток через браузер. Авторизацию берёт на себя внешнее приложение-хост: оно сохраняет токены на диск в ${MS_CONFIG_DIR}/credentials/ и заполняет accounts.json. Без готовых файлов токенов на диске вызовы немедленно завершатся ошибкой auth_required.
Для работы нужны Node.js 20 и npm. Обязательно укажите MS_CLIENT_ID из Microsoft Entra и путь к MS_CONFIG_DIR. Запросы к Graph API по умолчанию ограничены таймаутом в 60000 мс, а вложения скачиваются во временный каталог операционной системы.
Какие задачи решает
- искать важные письма по отправителю и статусу прочтения
- отправлять ответы в существующие треды Outlook
- сохранять входящие почтовые вложения на диск
- настраивать автоответчик об отсутствии на рабочем месте
Примеры запросов агенту
- Найди пять последних непрочитанных писем от [email protected] и ответь на самое свежее
- Скачай вложения из письма с темой Отчёт по бюджету
- Поставь автоответчик об отпуске до следующего понедельника
Как установить Microsoft 365 Mail
Командой платформы
claude mcp add --env MS_CLIENT_ID=<MS_CLIENT_ID> --env MS_CONFIG_DIR=<MS_CONFIG_DIR> --env MS_ACCOUNT_EMAIL=<MS_ACCOUNT_EMAIL> --env MS_MCP_PACKAGE_ID=<MS_MCP_PACKAGE_ID> --env MICROSOFT_REQUEST_TIMEOUT_MS=<MICROSOFT_REQUEST_TIMEOUT_MS> --transport stdio microsoft-mail -- npx -y @mindstone/mcp-server-microsoft-mailВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add microsoft-mail --env MS_CLIENT_ID=<MS_CLIENT_ID> --env MS_CONFIG_DIR=<MS_CONFIG_DIR> --env MS_ACCOUNT_EMAIL=<MS_ACCOUNT_EMAIL> --env MS_MCP_PACKAGE_ID=<MS_MCP_PACKAGE_ID> --env MICROSOFT_REQUEST_TIMEOUT_MS=<MICROSOFT_REQUEST_TIMEOUT_MS> -- npx -y @mindstone/mcp-server-microsoft-mailВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"microsoft-mail": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-microsoft-mail"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>",
"MS_CONFIG_DIR": "<MS_CONFIG_DIR>",
"MS_ACCOUNT_EMAIL": "<MS_ACCOUNT_EMAIL>",
"MS_MCP_PACKAGE_ID": "<MS_MCP_PACKAGE_ID>",
"MICROSOFT_REQUEST_TIMEOUT_MS": "<MICROSOFT_REQUEST_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"microsoft-mail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-microsoft-mail"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>",
"MS_CONFIG_DIR": "<MS_CONFIG_DIR>",
"MS_ACCOUNT_EMAIL": "<MS_ACCOUNT_EMAIL>",
"MS_MCP_PACKAGE_ID": "<MS_MCP_PACKAGE_ID>",
"MICROSOFT_REQUEST_TIMEOUT_MS": "<MICROSOFT_REQUEST_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e MS_CLIENT_ID=<MS_CLIENT_ID> -e MS_CONFIG_DIR=<MS_CONFIG_DIR> -e MS_ACCOUNT_EMAIL=<MS_ACCOUNT_EMAIL> -e MS_MCP_PACKAGE_ID=<MS_MCP_PACKAGE_ID> -e MICROSOFT_REQUEST_TIMEOUT_MS=<MICROSOFT_REQUEST_TIMEOUT_MS> microsoft-mail npx -y @mindstone/mcp-server-microsoft-mailВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Microsoft 365 Mail
Как установить Microsoft 365 Mail в Claude Code?
Выполните команду `claude mcp add mcp-server-microsoft-mail -e MS_CLIENT_ID=<MS_CLIENT_ID> -e MS_CONFIG_DIR=<MS_CONFIG_DIR> -- npx -y @mindstone/mcp-server-microsoft-mail`. Замените плейсхолдеры на ваш идентификатор приложения из Entra и путь к рабочей папке с токенами.
Что делает MCP-сервер Microsoft 365 Mail?
Он предоставляет набор из 22 инструментов для управления ящиком Outlook через Microsoft Graph. Агент сможет просматривать переписку, скачивать файлы, отправлять письма и менять флаги сообщений.
Почему сервер требует заранее настроенный MS_CONFIG_DIR?
Сервер сам не выполняет авторизацию через браузер. Он считывает уже готовые файлы токенов, которые хост-приложение сохраняет в ${MS_CONFIG_DIR}/credentials/.
