Proton Mail Bridge MCP и CLI

Proton Mail для Claude Desktop, сделанный как надо.

🌉 Proton Mail Bridge MCP — это локальная интеграция Proton Mail для Claude Desktop и терминала. Она позволяет читать, искать, создавать черновики, отправлять, синхронизировать и управлять Proton Mail через Proton Bridge, предоставляя как полноценный MCP-сервер, так и настоящий CLI.

После настройки Claude Desktop использует стабильную локальную установку этого MCP на вашем компьютере. Он не ограничен одним репозиторием, одной рабочей областью или одной папкой чата.

Простой способ понять, как это работает:

установите Proton Mail Bridge MCP на свой компьютер
подключите его к Claude Desktop

Вам не нужно понимать внутреннее устройство MCP, чтобы использовать его. Если Proton Bridge уже работает на вашей машине, настройка будет простой.

60-секундная настройка

Если Proton Bridge уже работает на вашей машине:

git clone https://github.com/googlarz/proton-mail-bridge-mcp.git
cd proton-mail-bridge-mcp
npm install
npm run setup:claude-desktop

Затем:

оставьте Proton Bridge запущенным
перезапустите Claude Desktop
откройте любой чат и выберите + -> Connectors -> proton-mail-bridge

Если вы также хотите быструю проверку работоспособности через терминал:

npm run check:claude-desktop
proton-mail-bridge doctor --json

Используйте команды npm run ..., указанные в этом README.

Это важно, так как точки входа для настройки и установщика находятся в собранном выводе dist/, а npm-скрипты уже указывают на нужные файлы для вас.

Почему люди используют это

Читайте Proton Mail прямо из Claude Desktop, не переключаясь между инструментами.
Быстрее ищите счета, письма о поездках, документы и цепочки писем.
Создавайте черновики, отвечайте, пересылайте и отправляйте письма через Proton Bridge.
Используйте один и тот же бэкенд из Claude Desktop или прямо из терминала.
Быстро диагностируйте проблемы с настройкой Claude Desktop и Proton Bridge.

Почему это существует

У Claude есть встроенный коннектор для Gmail, но на сегодняшний день нет встроенного коннектора для Proton Mail. Этот проект закрывает данный пробел для пользователей Proton.

Оригинальная идея protonmail-pro-mcp была многообещающей, но кодовая база, с которой я начал, была непригодна для использования «как есть». Я пересобрал её в рабочий MCP-сервер, реализовал недостающие части и добавил длинный список улучшений, чтобы проект стал действительно полезным в повседневной работе.

В чем он хорош:

Реальная поддержка Proton через Proton Bridge.
Операции чтения и записи: черновики, отправка, ответ, пересылка, архивация, корзина, восстановление.
Доступ к содержимому вложений и сохранение файлов.
Локальная индексация, сортировка цепочек писем, просмотр последующих действий и фоновое обновление.
Локальная настройка Claude Desktop, которая становится доступной для всей системы после установки.
Настоящий CLI для синхронизации, поиска, чтения, диагностики, обслуживания Claude Desktop и выполнения всех инструментов MCP из терминала.

Чего ожидать:

Он работает локально на вашей машине вместе с Proton Bridge.
Он подключается к Claude Desktop, но не является официальным коннектором Claude.
Ссылки на источники берутся из слоя MCP, а не из нативных ссылок веб-почты Proton.
После установки Claude Desktop может использовать его во всех ваших чатах на этом компьютере.

Доверие и безопасность

Работает локально на вашей машине.
Общается с Proton Mail через Proton Bridge на вашей машине.
Не требует хостинга почтового реле или удаленного URL-сервиса.
Может работать в режиме «только чтение», если вам нужны более безопасные настройки по умолчанию.
Поддерживает секреты *_FILE и *_COMMAND, если вы не хотите хранить открытые учетные данные в конфигурации.
Выполняет отправку или изменение почтовых ящиков только тогда, когда вы явно используете эти возможности.

Проверенные возможности

Эти пути были протестированы в реальной настройке Proton Bridge:

IMAP-соединение и список папок
SMTP-соединение и отправка
чтение сообщений целиком
локальная индексация и инкрементальная синхронизация
просмотр цепочек писем, дайджесты и рабочие процессы для последующих действий
синхронизация удаленных черновиков с Proton Drafts
список вложений и сохранение
CLI-команды плюс вызовы общих инструментов MCP

Что он делает

Подключает Claude к Proton Mail через IMAP и SMTP Proton Bridge.
Читает папки, сообщения и вложения.
Ищет по текущей почте и локально проиндексированной почте.
Создает, обновляет, синхронизирует и отправляет черновики.
Отправляет электронную почту, отвечает и пересылает.
Помечает как прочитанные или непрочитанные, ставит или снимает «звездочки», перемещает, архивирует, удаляет в корзину, восстанавливает и удаляет окончательно.
Создает локальный индекс SQLite с контрольными точками инкрементальной синхронизации.
Отслеживает изменения в почтовом ящике с обновлением через IMAP IDLE.
Реконструирует нормализованные метки и цепочки писем из данных IMAP.
Классифицирует больше типов вложений, включая встроенные изображения, приглашения в календарь, архивы и файлы подписей.
Генерирует полезные представления цепочек писем, дайджесты входящих, кандидатов для последующих действий, подготовку к встречам, представления для поиска документов и краткие сводки цепочек.
Поддерживает более безопасные предварительные просмотры (dry-run) для пакетных действий и действий с цепочками писем.
Выдает ссылки на ресурсы MCP и структурированные метаданные источника для последующего цитирования.

Полезно знать

Он использует Proton Bridge. Почему: этот проект подключается через локальный доступ IMAP и SMTP, который предоставляет Proton Bridge.
Он работает локально. Почему: Proton Bridge обычно работает на вашем собственном компьютере, поэтому этот MCP-сервер также спроектирован для локальной работы.
Цепочки писем и метки реконструируются из данных IMAP. Почему: нативные объекты цепочек и меток Proton здесь недоступны через официальный коннектор Claude.
Обработка вложений широкая, но не магическая. Почему: распространенные случаи работают хорошо, включая приглашения в календарь и обычные вложения документов/изображений, но форматы MIME электронной почты все еще могут быть сложными у разных отправителей и клиентов.

Что еще отсутствует и почему

Нет удаленного URL-коннектора «из коробки». Почему: текущий продукт общается с Proton Bridge на вашем собственном компьютере, а Proton Bridge обычно является локальным, а не хостинговым сервисом.
Нет официального потока аутентификации Claude или нативных глубоких ссылок Proton. Почему: они требуют поддержки на уровне платформы от Anthropic и более богатой поддержки провайдера от Proton, чем могут предложить IMAP и SMTP.
Нет настоящей нативной модели диалога Proton. Почему: этот проект реконструирует цепочки и метки из почтовых данных Bridge, вместо вызова более богатого API, специфичного для Proton.
Более нативный опыт Proton возможен в будущем. Почему: если Proton выпустит лучший путь для публичной интеграции или более чистую историю локального/хостингового моста, этот проект сможет приблизиться к нативному опыту Gmail. Я жду улучшения этой экосистемы.

Перед началом

Вам понадобятся:

Claude Desktop
Node.js 18 или новее
Учетная запись Proton
Установленный и авторизованный Proton Bridge
Около 10 минут

Из Proton Bridge вам понадобятся:

IMAP-хост
IMAP-порт
SMTP-хост
SMTP-порт
имя пользователя
пароль Bridge

Для большинства локальных настроек Bridge значения по умолчанию:

IMAP-хост: 127.0.0.1
IMAP-порт: 1143
SMTP-хост: 127.0.0.1
SMTP-порт: 1025

🚀 Обзор настройки

Настройка состоит из двух частей:

установка локального MCP-сервера
подключение его к Claude Desktop

Обычный путь — это мастер настройки с подсказками. Ручной путь предназначен только для тех, кому нужен больший контроль.

Важно:

папка репозитория нужна только для установки или обновления MCP
сам Claude Desktop будет использовать стабильную общесистемную среду выполнения после настройки
так что это для общего использования Claude Desktop на вашем компьютере, а не только для одной папки проекта

Часть 1: Установка Proton Mail Bridge MCP на ваш компьютер

1. 🔐 Откройте Proton Bridge

Откройте Proton Bridge и убедитесь, что ваша учетная запись подключена.

В Bridge откройте детали почтового ящика или представление «Configure email client» и скопируйте:

IMAP-хост и IMAP-порт
SMTP-хост и SMTP-порт
имя пользователя
пароль Bridge

Оставьте Proton Bridge запущенным. Не закрывайте его во время использования этого MCP.

2. 📥 Скачайте проект

git clone https://github.com/googlarz/proton-mail-bridge-mcp.git
cd proton-mail-bridge-mcp
npm install

Если хотите, вы также можете скачать исходный код из последнего релиза GitHub вместо клонирования репозитория.

Если npm отсутствует на вашей машине, сначала установите Node.js 18+, затем снова выполните команды.

На этом этапе файлы MCP-сервера находятся на вашем компьютере и готовы к шагу с Claude Desktop.

Вы можете клонировать репозиторий куда угодно. Эта папка используется для установки и обновлений. Claude Desktop не будет привязан к этой папке после завершения настройки.

Часть 2: Укажите Claude Desktop использовать его

3. 🪄 Настройте Proton Mail Bridge MCP для Claude Desktop

npm run setup:claude-desktop

Эта команда не устанавливает само приложение Claude Desktop.

Claude Desktop уже должен быть установлен.

Что делает эта команда:

проверяет стандартные локальные порты Proton Bridge
запрашивает ваше имя пользователя Proton Bridge и пароль Bridge
использует стандартные локальные адреса Bridge, если вы их не переопределите
собирает этот MCP-сервер
устанавливает стабильную локальную копию среды выполнения для Claude Desktop вне этого репозитория
записывает запись конфигурации Claude Desktop, которая говорит Claude, как запустить эту установленную среду выполнения
сохраняет значения PROTONMAIL_*, которые нужны этому MCP-серверу, внутри этой локальной конфигурации Claude Desktop
делает резервную копию старой конфигурации Claude Desktop перед ее изменением

Простыми словами:

эта команда устанавливает или обновляет интеграцию Proton Mail Bridge MCP для Claude Desktop на этом компьютере
она не устанавливает само приложение Claude Desktop
она не привязывает Claude к папке, из которой вы ее запустили

4. 🔁 Перезапустите Claude Desktop

После завершения работы мастера:

перезапустите Claude Desktop
оставьте Proton Bridge запущенным
откройте любой чат в Claude Desktop
нажмите кнопку + рядом с полем чата, затем откройте Connectors
подтвердите, что proton-mail-bridge появился там и что инструменты доступны
если хотите проверить еще раз, откройте настройки разработчика Claude Desktop и посмотрите статус/логи подключения MCP

Где установлена стабильная среда выполнения:

macOS: ~/Library/Application Support/Proton Mail Bridge MCP
Linux: ~/.local/share/proton-mail-bridge-mcp
Windows: %APPDATA%\Proton Mail Bridge MCP

🤖 Как это работает в Claude Desktop

Если у вас уже открыт Claude Desktop, вот что нужно знать в первую очередь:

Claude Desktop также поддерживает удаленные коннекторы, которые запрашивают URL.
Этот проект — не такой коннектор.
Он работает локально, потому что Proton Bridge также работает локально на вашей машине.
Поэтому правильная настройка здесь — это поток локальной установки Claude Desktop, а не поле для удаленного URL.

Почему это все еще полезно:

Gmail сегодня получает самый нативный опыт Claude
У пользователей Proton пока нет такого же официального пути
этот проект дает Claude Desktop практичную локальную интеграцию Proton прямо сейчас

Почему нет удаленного URL для вставки:

удаленный URL-коннектор ожидает хостинговый MCP-сервер
этот проект ожидает доступа к Proton Bridge на вашей машине
Proton Bridge обычно предоставляет локальный доступ IMAP/SMTP на 127.0.0.1
поэтому самая простая и безопасная настройка — локальная, а не удаленная

Это означает, что поддерживаемый путь Claude Desktop в текущем релизе:

npm run setup:claude-desktop для управляемого потока без ручной настройки
npm run install:claude-desktop для продвинутых или автоматизированных установок Claude Desktop
npm run update:claude-desktop для обновления установленной среды выполнения Claude Desktop после обновления этого репозитория
npm run doctor:claude-desktop для подтверждения того, что Claude Desktop все еще указывает на валидную среду выполнения Proton Mail Bridge MCP
путь локального расширения .mcpb, описанный в CLAUDE-DESKTOP-PACKAGING.md

🖥️ CLI

Вы также можете использовать Proton Mail Bridge MCP напрямую из терминала.

Это полезно, когда вы хотите:

протестировать Proton Bridge, не открывая Claude Desktop
выполнять быстрый поиск или чтение за меньшее количество шагов
скриптовать синхронизацию и диагностику
проверить, работает ли локальный почтовый стек, прежде чем просить Claude использовать его
вызывать полную поверхность инструментов MCP прямо из терминала

Бинарный файл CLI:

proton-mail-bridge

Или из репозитория:

npm run cli -- help

Основные команды:

proton-mail-bridge status
proton-mail-bridge doctor
proton-mail-bridge sync --folder INBOX --limit 150
proton-mail-bridge search "label:inbox invoice"
proton-mail-bridge search --live --from openai.com
proton-mail-bridge read INBOX::25642
proton-mail-bridge tools
proton-mail-bridge tool get_connection_status
proton-mail-bridge tool search_indexed_emails --args '{"query":"invoice","limit":3}'
proton-mail-bridge claude check
proton-mail-bridge claude install

Большинство команд также поддерживают --json для машиночитаемого вывода.

Практические примеры:

# Check whether Proton Bridge and Claude-side wiring are healthy
proton-mail-bridge doctor --json

# Search indexed mail
proton-mail-bridge search "label:inbox invoice" --limit 10

# Read one message
proton-mail-bridge read INBOX::25642

# Call any MCP tool directly from Terminal
proton-mail-bridge tools
proton-mail-bridge tool get_connection_status --json
proton-mail-bridge tool search_indexed_emails --args '{"query":"invoice","limit":3}'

# Check Claude Desktop integration
proton-mail-bridge claude check --json

Если вы хотите, чтобы CLI достигал всего, что предоставляет MCP-сервер, используйте:

proton-mail-bridge tools
proton-mail-bridge tool <tool-name> --args '{"key":"value"}'
proton-mail-bridge tool <tool-name> --args-file ./input.json

Это дает вам два способа использования одной и той же системы:

Claude Desktop использует его как MCP-сервер
Терминал использует его как CLI, включая вызовы общих инструментов MCP

Путь без ручной настройки для пользователей Bridge

Откройте терминал в папке проекта.
Запустите:

npm run setup:claude-desktop

Ответьте на запросы для:
- вашего имени пользователя Proton Bridge
- вашего пароля Proton Bridge
- хотите ли вы использовать стандартные локальные порты

Proton Mail Bridge MCP