# mailbox-mcp

Подключает почтовые ящики Gmail, IMAP и JMAP к AI-агенту. Ищет письма, создаёт черновики и защищает контекст от скрытых prompt-инъекций.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Автор: jgalea
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jgalea/mailbox-mcp
- Обновлён: 2026-10-11
- HTML: https://affpapa.org/nevibecode/mcp/mailbox-mcp

## Что делает

mailbox-mcp связывает агентные среды с почтовыми провайдерами через протокол MCP. Сервер объединяет несколько аккаунтов в одном процессе, поддерживая официальный API Gmail, протоколы IMAP и SMTP, а также JMAP для ящиков вроде Fastmail. В наборе предусмотрено 49 инструментов для чтения, поиска, разметки ярлыками и подготовки ответов.

Главный упор сделан на изоляцию непроверенного текста. Входящие письма экранируются случайными одноразовыми токенами, а скрытый HTML-код, невидимые шрифты и управляющие символы сервер вырезает до передачи в модель. Для отправки почты действуют лимиты: по умолчанию разрешено не более 10 писем в минуту и 100 в сутки.

Учётные данные шифруются по алгоритму AES-256-GCM, поэтому для запуска обязательно передавать переменную `MAILBOX_MCP_PASSPHRASE`. Если нужно полностью исключить спонтанную отправку агентом, аккаунт можно перевести в режим `draftsOnly` или включить подтверждение очереди через системный терминал.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `MAILBOX_MCP_PASSPHRASE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mailbox-mcp -e MAILBOX_MCP_PASSPHRASE=<MAILBOX_MCP_PASSPHRASE> -- npx -y mailbox-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mailbox-mcp --env MAILBOX_MCP_PASSPHRASE=<MAILBOX_MCP_PASSPHRASE> -- npx -y mailbox-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mailbox-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mailbox-mcp"
            ],
            "env": {
                "MAILBOX_MCP_PASSPHRASE": "<MAILBOX_MCP_PASSPHRASE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mailbox-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mailbox-mcp"
            ],
            "env": {
                "MAILBOX_MCP_PASSPHRASE": "<MAILBOX_MCP_PASSPHRASE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MAILBOX_MCP_PASSPHRASE=<MAILBOX_MCP_PASSPHRASE> mailbox-mcp npx -y mailbox-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- искать нужные переписки и счета сразу в нескольких ящиках
- составлять черновики ответов без перехода в почтовый клиент
- блокировать скрытые prompt-инъекции из входящих HTML-писем
- настроить лимиты и терминальное подтверждение исходящих писем

## Примеры запросов агенту
- Найди в рабочем ящике последние письма с вложенными счетами за этот месяц
- Подготовь черновик ответа клиенту по последней цепочке в ящике Fastmail
- Проверь почту на непрочитанные сообщения и сгруппируй их по отправителям

## Похожие
- [MCPEmails](https://affpapa.org/nevibecode/mcp/mcpemails.md) — MCP-сервер · ★ 13
- [email-mcp](https://affpapa.org/nevibecode/mcp/marlinjai-email-mcp.md) — MCP-сервер · ★ 26
- [gigamail](https://affpapa.org/nevibecode/mcp/gigamail.md) — MCP-сервер · ★ 17
- [cargo-mailbox-management](https://affpapa.org/nevibecode/skills/cargo-mailbox-management.md) — скилл · 5200 установок
- [MailFathom](https://affpapa.org/nevibecode/mcp/mailfathom.md) — MCP-сервер · ★ 19
- [Agent Mail Gateway](https://affpapa.org/nevibecode/mcp/agent-mail-gateway.md) — MCP-сервер · ★ 12

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md