Proton Mail Bridge Client MCP
MCP-сервер и CLI для Proton Mail через Proton Bridge: поиск, черновики и разбор почты с режимами безопасности read-only и drafts
- 89 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Сервер читает всю почту и может отправлять и удалять письма, если режим `full`; тексты писем доступны модели.
- Письма могут содержать вложенные инструкции, поэтому для разбора чужой почты берут режим `drafts` или `read-only`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/proton-mail-bridge-clientОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер читает всю почту и может отправлять и удалять письма, если режим `full`; тексты писем доступны модели.
- Письма могут содержать вложенные инструкции, поэтому для разбора чужой почты берут режим `drafts` или `read-only`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает Claude Desktop, Cline и другие MCP-клиенты к Proton Mail через локальный Proton Bridge. Он обращается только к Bridge на `127.0.0.1` и хранит индекс почты на вашем диске. Агент ищет письма, читает цепочки, готовит черновики, отправляет и раскладывает почту по папкам; полный набор содержит 129 инструментов, а режим `PROTONMAIL_TOOL_TIER=core` сокращает его до 25. Режим задает переменная `PROTONMAIL_MODE`: `read-only` только читает, `drafts` готовит черновики без отправки, перемещений и удаления, `assisted` просит подтверждение, `full` разрешает все. Через `PROTONMAIL_APPROVAL=elicit` подтверждение запрашивается у человека через клиент. Изменения можно писать в журнал аудита с цепочкой хешей. Те же инструменты доступны как CLI для скриптов и планировщика, есть утренний дайджест.
Для кого. Пользователям Proton Mail, которые хотят разбирать входящие и готовить ответы через Claude, держа отправку и удаление под своим контролем.
Подходит, если
- Утром нужен дайджест новых писем и список цепочек, где ждут ответа
- Агент находит последнее письмо от адресата и готовит черновик, который вы проверите
- Почту с вложениями за месяц нужно найти по большой локальной базе писем
- Те же операции вызывают из cron и скриптов без Claude через CLI
Не подходит, если
- Нужен доступ к Proton Mail без запущенного Proton Bridge: сервер работает только через него
- Почту нельзя показывать внешней модели и локальной модели нет: тексты писем уходят провайдеру модели
- Нужен единственный режим «отправлять сразу без подтверждения» в автоматическом конвейере без аудита
Пример запроса к агенту
Дай дайджест входящих за сегодня, отметь письма, на которые нужно ответить, и подготовь черновик ответа АлисеMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
PROTONMAIL_USERNAMEобязательная- Адрес Proton Mail.
PROTONMAIL_PASSWORDобязательная, секрет- Пароль Bridge из приложения Proton Bridge.
PROTONMAIL_MODE- Режим безопасности: read-only, drafts, assisted или full.
PROTONMAIL_APPROVAL- Способ подтверждения отправки и удаления: elicit или require.
Ограничения
Нужны установленный и запущенный Proton Mail Bridge и пароль Bridge, это не пароль от аккаунта Proton. Для пакета нужен Node.js 22 или новее. Если `PROTONMAIL_MODE` не задан, сервер работает в режиме `full` и может отправлять письма без подтверждения, а свежая установка `setup-claude-desktop` записывает `drafts`. Тексты писем, которые читает модель, уходят провайдеру модели, если модель облачная. Подтверждение через `elicit` зависит от поддержки клиентом, жестко ограничивает только `require`.
Как отключить. Удалите запись `proton-mail-bridge` из конфигурации MCP-клиента и выполните `npm uninstall -g proton-mail-bridge-client`. Локальный индекс и журнал аудита стирают отдельно.
Частые вопросы
Как подключить сервер к Claude Desktop?
Поставьте пакет командой `npm install -g proton-mail-bridge-client` и выполните `proton-mail-bridge-client setup-claude-desktop`, он проверит порты Bridge и запишет конфигурацию. Есть и пакет `.mcpb` в релизах. Claude Desktop полностью перезапустите.
Какой режим безопасности выбрать сначала?
`PROTONMAIL_MODE=drafts`: агент читает, ищет и готовит черновики, но ничего не отправляет и не удаляет. Для чистого чтения есть `read-only`.
Что такое пароль Bridge?
Отдельный пароль, который показывает приложение Proton Bridge в настройках вашего аккаунта. Пароль аккаунта Proton сервер не использует.
Проверяет ли сервер инструкции внутри писем?
Сервер сообщает клиенту, что инструкции из текста писем выполнять нельзя. Это защита по умолчанию, но не гарантия: ограничения режима надежнее.
Работает ли сервер с другими клиентами, кроме Claude Desktop?
Да, подойдут Cline и любой MCP-клиент. Команда сервера в конфигурации называется `proton-mail-bridge-mcp`, учетные данные задают переменными `PROTONMAIL_*`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
MCP-сервер для Apple Mail на macOS: поиск, чтение, черновики, правила и вложения, опасные шаги с подтверждением.
MCP-сервер к почте на Mac: агент читает, ищет, пишет, сортирует письма и разбирает ящик, есть режим только для чтения
imap-mcp-server — почта по IMAP и SMTP для агента
imap-mcp-server
MCP-сервер дает агенту искать, читать, отправлять и чистить письма в нескольких ящиках, а пароли хранит под шифрованием AES-256
MCP-сервер для почты Mail.ru в Claude.ai и отдельный Telegram-бот, который каждые 15 минут проверяет ящик и присылает уведомления о важных письмах
Расширение для Thunderbird и MCP-мост: агент ищет письма, пишет черновики, ведет фильтры, контакты и календари, 49 инструментов
Коротко о README
В README разобраны установка, варианты запуска через `.mcpb` и npm, режимы безопасности, журнал аудита и CLI. Отдельные документы разбирают модель угроз, полностью локальную работу и установку без терминала.