# Email Inbox API + Sending by Sendmux

MCP-сервер Sendmux даёт агенту доступ к почтовому ящику и отправке писем: входящие, вложения, поиск, вебхуки и события.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 62
- Автор: Sendmux
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Sendmux/sendmux-sdk/tree/HEAD/packages/python/mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/email-inbox-api-sending-by-sendmux

## Что делает

Sendmux поднимает три поверхности инструментов: mailbox для работы с ящиком, sending для отправки и management для управления доменами и ресурсами. Внутри — разбор входящей почты в чистый JSON, вложения, поиск по ящику, живые события и вебхуки. Маршрутизацией между провайдерами занимается сам Sendmux.

Запустить можно локально через `pip install sendmux-mcp` и команды `sendmux-mcp-mailbox`, `sendmux-mcp-management`, `sendmux-mcp-sending` — каждая выбирает одну поверхность. Есть общий `sendmux-mcp` с переменной `SENDMUX_MCP_SURFACES`. Транспорт по умолчанию — `stdio`; режим HTTP слушает `127.0.0.1:8765/mcp` и требует отдельный bearer-токен, если не отключить проверку явно.

Нужен Python 3.10 или новее. Для sending-инструментов понадобится ключ `smx_mbx_*` с правом отправки либо одобренный владельцем токен `smx_agent_*` на ресурс Sending, для mailbox — ключ с областью ящика, для management — корневой `smx_root_*`. В версии 2.0.0 из инструментов вложений убрали локальные `file_path` и roots-входы, поэтому перед обновлением самоуправляемой установки сохраните рабочее окружение и конфигурацию клиента: откат пакета не отменяет уже выполненные загрузки и отправки.

Есть публичный хост `https://mcp.sendmux.ai/mcp` — для него нужен HTTP-транспорт с OAuth, без ручных заголовков `Authorization` и ключей. Тот же рантайм отдаёт A2A 1.0 по адресу `https://a2a.sendmux.ai/a2a/v1`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.sendmux.ai/mcp`
- Переменные окружения: `SENDMUX_MCP_SURFACES`, `SENDMUX_MAILBOX_API_KEY`, `SENDMUX_MANAGEMENT_API_KEY`, `SENDMUX_SENDING_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http sendmux-mcp https://mcp.sendmux.ai/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env SENDMUX_MCP_SURFACES=<SENDMUX_MCP_SURFACES> --env SENDMUX_MAILBOX_API_KEY=<SENDMUX_MAILBOX_API_KEY> --env SENDMUX_MANAGEMENT_API_KEY=<SENDMUX_MANAGEMENT_API_KEY> --env SENDMUX_SENDING_API_KEY=<SENDMUX_SENDING_API_KEY> --transport stdio mcp -- npx -y sendmux-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add mcp --url https://mcp.sendmux.ai/mcp
```

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mcp https://mcp.sendmux.ai/mcp
```

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

## Когда брать
- прочитать входящие письма из ящика и вернуть их в JSON
- отправить письмо с вложением из агента
- найти письмо по ящику через инструмент
- подписаться на новые письма через вебхук
- разложить работу с почтой по поверхностям mailbox, sending и management

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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