mailbox-mcp — MCP-сервер для Claude Code: что делает и как установить
Подключает почтовые ящики Gmail, IMAP и JMAP к AI-агенту. Ищет письма, создаёт черновики и защищает контекст от скрытых prompt-инъекций.
claude mcp add mailbox-mcp -e MAILBOX_MCP_PASSPHRASE=<MAILBOX_MCP_PASSPHRASE> -- npx -y mailbox-mcpЧто делает mailbox-mcp
mailbox-mcp связывает агентные среды с почтовыми провайдерами через протокол MCP. Сервер объединяет несколько аккаунтов в одном процессе, поддерживая официальный API Gmail, протоколы IMAP и SMTP, а также JMAP для ящиков вроде Fastmail. В наборе предусмотрено 49 инструментов для чтения, поиска, разметки ярлыками и подготовки ответов.
Главный упор сделан на изоляцию непроверенного текста. Входящие письма экранируются случайными одноразовыми токенами, а скрытый HTML-код, невидимые шрифты и управляющие символы сервер вырезает до передачи в модель. Для отправки почты действуют лимиты: по умолчанию разрешено не более 10 писем в минуту и 100 в сутки.
Учётные данные шифруются по алгоритму AES-256-GCM, поэтому для запуска обязательно передавать переменную MAILBOX_MCP_PASSPHRASE. Если нужно полностью исключить спонтанную отправку агентом, аккаунт можно перевести в режим draftsOnly или включить подтверждение очереди через системный терминал.
Какие задачи решает
- искать нужные переписки и счета сразу в нескольких ящиках
- составлять черновики ответов без перехода в почтовый клиент
- блокировать скрытые prompt-инъекции из входящих HTML-писем
- настроить лимиты и терминальное подтверждение исходящих писем
Примеры запросов агенту
- Найди в рабочем ящике последние письма с вложенными счетами за этот месяц
- Подготовь черновик ответа клиенту по последней цепочке в ящике Fastmail
- Проверь почту на непрочитанные сообщения и сгруппируй их по отправителям
Как установить mailbox-mcp
Командой платформы
claude mcp add mailbox-mcp -e MAILBOX_MCP_PASSPHRASE=<MAILBOX_MCP_PASSPHRASE> -- npx -y mailbox-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mailbox-mcp --env MAILBOX_MCP_PASSPHRASE=<MAILBOX_MCP_PASSPHRASE> -- npx -y mailbox-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mailbox-mcp": {
"command": "npx",
"args": [
"-y",
"mailbox-mcp"
],
"env": {
"MAILBOX_MCP_PASSPHRASE": "<MAILBOX_MCP_PASSPHRASE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mailbox-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mailbox-mcp"
],
"env": {
"MAILBOX_MCP_PASSPHRASE": "<MAILBOX_MCP_PASSPHRASE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MAILBOX_MCP_PASSPHRASE=<MAILBOX_MCP_PASSPHRASE> mailbox-mcp npx -y mailbox-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mailbox-mcp
Как установить mailbox-mcp в Claude Code?
Выполните команду claude mcp add mailbox-mcp -e MAILBOX_MCP_PASSPHRASE=<MAILBOX_MCP_PASSPHRASE> -- npx -y mailbox-mcp, указав свой пароль для шифрования хранилища.
Что делает MCP-сервер mailbox-mcp?
Он даёт ассистенту доступ к электронной почте на базе Gmail, IMAP и JMAP. Модель может читать треды, искать сообщения, управлять ярлыками и готовить черновики.
Как сервер защищает от вредоносных писем?
Сервер оборачивает текст писем в одноразовые токены и вырезает скрытые элементы HTML. Для неизвестных адресатов запрашивается подтверждение, а отправку можно заблокировать флагом draftsOnly.
