____  ____   ___ _____ ___  _   _   __  __    _    ___ _
 |  _ \|  _ \ / _ \_   _/ _ \| \ | | |  \/  |  / \  |_ _| |
 | |_) | |_) | | | || || | | |  \| | | |\/| | / _ \  | || |
 |  __/|  _ <| |_| || || |_| | |\  | | |  | |/ ___ \ | || |___
 |_|   |_| \_\\___/ |_| \___/|_| \_| |_|  |_/_/   \_\___|_____|
  Bridge Client  ·  CLI + Claude Desktop MCP for Proton Mail

Клиент Proton Mail Bridge

Полнофункциональный CLI и MCP-сервер для Claude Desktop для Proton Mail, построенный на базе Proton Bridge.

О программе

Клиент Proton Mail Bridge предоставляет два способа программного использования Proton Mail:

CLI — терминальный клиент с полной функциональностью MCP. Чтение, поиск, отправка, черновики, архивация, управление папками, сортировка цепочек писем и диагностика — всё из командной строки. Тело письма можно передать через stdin. Вывод доступен в человекочитаемом формате или в --json.

MCP-сервер — те же возможности, представленные в виде сервера Model Context Protocol, чтобы Claude Desktop мог читать и управлять вашей почтой Proton Mail в любом чате на том же компьютере, где запущен Proton Bridge.

Оба интерфейса используют один бэкенд: IMAP и SMTP протоколы Proton Bridge, локальный индекс SQLite и журнал аудита. Никаких сторонних ретрансляторов, удаленных URL или облачных зависимостей, кроме вашего собственного аккаунта Proton.

Системные требования

• Node.js 18+

• Установленный и авторизованный Proton Bridge

• Данные из Bridge: хост/порт IMAP, хост/порт SMTP, имя пользователя, пароль Bridge

Локальные адреса Bridge по умолчанию: IMAP 127.0.0.1:1143, SMTP 127.0.0.1:1025

Установка

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

После установки бинарный файл proton-mail-bridge-client (и proton-mail-bridge) будет доступен из репозитория.

Для системной установки: npm install -g .

CLI

proton-mail-bridge-client <command> [options]

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

Чтение

proton-mail-bridge-client emails --folder INBOX --limit 25
proton-mail-bridge-client read INBOX::25642
proton-mail-bridge-client search "invoice" --limit 10
proton-mail-bridge-client search --live --from openai.com
proton-mail-bridge-client attachments INBOX::25642

Сортировка

proton-mail-bridge-client digest
proton-mail-bridge-client threads "quarterly review"
proton-mail-bridge-client actionable
proton-mail-bridge-client followups
proton-mail-bridge-client thread-brief <threadId>
proton-mail-bridge-client document-threads --category invoice
proton-mail-bridge-client meeting-context alice@example.com

Написание и отправка

proton-mail-bridge-client send --to bob@example.com --subject "Hey" --body "Hello"
echo "Hello" | proton-mail-bridge-client send --to bob@example.com --subject "Hey"
proton-mail-bridge-client reply INBOX::25642 --body "On it."
proton-mail-bridge-client reply INBOX::25642 --reply-all --body "On it."
proton-mail-bridge-client forward INBOX::25642 --to carol@example.com

Действия с почтовым ящиком

proton-mail-bridge-client move INBOX::25642 Folders/Archive
proton-mail-bridge-client archive INBOX::25642
proton-mail-bridge-client trash INBOX::25642
proton-mail-bridge-client restore Trash::25642
proton-mail-bridge-client mark-read INBOX::25642
proton-mail-bridge-client mark-read INBOX::25642 --unread
proton-mail-bridge-client star INBOX::25642
proton-mail-bridge-client delete INBOX::25642
proton-mail-bridge-client batch archive INBOX::100,INBOX::101,INBOX::102
proton-mail-bridge-client thread-action <threadId> archive

Папки

proton-mail-bridge-client folders
proton-mail-bridge-client create-folder Folders/Receipts
proton-mail-bridge-client rename-folder Folders/Receipts Folders/Bills
proton-mail-bridge-client delete-folder Folders/Bills

Черновики

proton-mail-bridge-client drafts
proton-mail-bridge-client draft-create --to bob@example.com --subject "Draft" --body "..."
proton-mail-bridge-client draft-read <id>
proton-mail-bridge-client draft-update <id> --subject "Updated subject"
proton-mail-bridge-client draft-reply INBOX::25642 --body "Will do."
proton-mail-bridge-client draft-forward INBOX::25642 --to carol@example.com
proton-mail-bridge-client draft-sync <id>
proton-mail-bridge-client draft-send <id>
proton-mail-bridge-client draft-delete <id>
proton-mail-bridge-client remote-drafts

Аналитика и диагностика

proton-mail-bridge-client stats
proton-mail-bridge-client analytics
proton-mail-bridge-client contacts
proton-mail-bridge-client volume-trends --days 14
proton-mail-bridge-client watch --timeout 30
proton-mail-bridge-client test-email you@example.com
proton-mail-bridge-client doctor
proton-mail-bridge-client status
proton-mail-bridge-client sync --folder INBOX --limit 150

Проброс инструментов MCP

Любой инструмент MCP также можно вызвать напрямую из CLI:

proton-mail-bridge-client tools
proton-mail-bridge-client tool get_connection_status --json
proton-mail-bridge-client tool search_indexed_emails --args '{"query":"invoice","limit":3}'

Окружение

CLI и MCP-сервер считывают одни и те же переменные окружения:

export PROTONMAIL_USERNAME='you@proton.me'
export PROTONMAIL_PASSWORD='your-bridge-password'
export PROTONMAIL_IMAP_HOST='127.0.0.1'
export PROTONMAIL_IMAP_PORT='1143'
export PROTONMAIL_IMAP_SECURE='false'
export PROTONMAIL_SMTP_HOST='127.0.0.1'
export PROTONMAIL_SMTP_PORT='1025'
export PROTONMAIL_DATA_DIR="$HOME/.proton-mail-bridge-client"

Дополнительные секреты через файл или команду (позволяет избежать хранения учетных данных в открытом виде в оболочке):

export PROTONMAIL_USERNAME_FILE='/path/to/user.txt'
export PROTONMAIL_PASSWORD_FILE='/path/to/pass.txt'
# or
export PROTONMAIL_USERNAME_COMMAND='pass proton/username'
export PROTONMAIL_PASSWORD_COMMAND='pass proton/password'

Полный список флагов времени выполнения:

export PROTONMAIL_READ_ONLY='false'
export PROTONMAIL_ALLOW_SEND='true'
export PROTONMAIL_ALLOW_REMOTE_DRAFT_SYNC='true'
export PROTONMAIL_ALLOWED_ACTIONS='mark_read,mark_unread,star,unstar,archive,trash,restore'
export PROTONMAIL_AUTO_SYNC='true'
export PROTONMAIL_STARTUP_SYNC='true'
export PROTONMAIL_SYNC_INTERVAL_MINUTES='5'
export PROTONMAIL_IDLE_WATCH='true'
export PROTONMAIL_IDLE_MAX_SECONDS='30'

Настройка Claude Desktop

Чтобы использовать клиент Proton Mail Bridge с Claude Desktop, запустите мастер настройки:

npm run setup:claude-desktop

Это позволит:

• проверить локальные порты Bridge

• запросить имя пользователя и пароль Bridge

• собрать проект

• установить стабильную среду выполнения для всей системы

• записать конфигурацию MCP в Claude Desktop

После настройки: перезапустите Claude Desktop, оставьте Proton Bridge запущенным, затем проверьте + → Connectors → proton-mail-bridge.

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

• macOS: ~/Library/Application Support/Proton Mail Bridge Client

• Linux: ~/.local/share/proton-mail-bridge-client

• Windows: %APPDATA%\Proton Mail Bridge Client

Обновление

git pull
npm run update:claude-desktop

Ручная настройка Claude Desktop

{
  "mcpServers": {
    "proton-mail-bridge": {
      "command": "node",
      "args": ["/path/to/runtime/dist/index.js"],
      "cwd": "/path/to/runtime",
      "env": {
        "PROTONMAIL_USERNAME": "you@proton.me",
        "PROTONMAIL_PASSWORD": "your-bridge-password",
        "PROTONMAIL_IMAP_HOST": "127.0.0.1",
        "PROTONMAIL_IMAP_PORT": "1143",
        "PROTONMAIL_IMAP_SECURE": "false",
        "PROTONMAIL_SMTP_HOST": "127.0.0.1",
        "PROTONMAIL_SMTP_PORT": "1025"
      }
    }
  }
}

Примечание для macOS

В macOS better-sqlite3 должен быть нативным бинарным файлом, собранным для текущей машины. Установщик обрабатывает это автоматически. Если вы восстанавливаете систему из другого окружения или видите сбой нативного модуля, выполните npm run update:claude-desktop.

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

• Работает полностью локально — никаких сторонних ретрансляторов или удаленных URL.

• Взаимодействует с Proton Mail только через Proton Bridge на вашем компьютере.

• PROTONMAIL_READ_ONLY=true отключает все операции записи.

• PROTONMAIL_ALLOW_SEND=false отключает отправку через SMTP, не затрагивая другие операции записи.

• PROTONMAIL_ALLOWED_ACTIONS управляет тем, какие изменения в почтовом ящике разрешены.

• batch_email_action и apply_thread_action поддерживают dryRun: true.

• Поддерживает секреты *_FILE и *_COMMAND, поэтому учетные данные никогда не появляются в конфигурации или истории командной строки.

• Системные папки (Входящие, Отправленные, Корзина, Спам, Архив, Вся почта) защищены от случайного удаления.

Сравнение с нативным коннектором Gmail для Claude

Набор инструментов

Отправка

send_email · send_test_email · reply_to_email · forward_email

Черновики

create_draft · create_reply_draft · create_forward_draft · create_thread_reply_draft · list_drafts · list_remote_drafts · get_draft · update_draft · sync_draft_to_remote · send_draft · delete_draft

Чтение

get_emails · get_email_by_id · search_emails · list_attachments · get_attachment_content · save_attachments · save_attachment

Сортировка

get_folders · sync_folders · get_labels · get_threads · get_thread_by_id · get_thread_brief · get_actionable_threads · get_inbox_digest · get_follow_up_candidates · find_document_threads · prepare_meeting_context

Действия

mark_email_read · star_email · move_email · archive_email · trash_email · restore_email · delete_email · batch_email_action · apply_thread_action

Управление папками

create_folder · rename_folder · delete_folder

Аналитика

get_email_stats · get_email_analytics · get_contacts · get_volume_trends

Диагностика

get_connection_status · get_runtime_status · run_doctor · get_audit_logs · run_background_sync · wait_for_mailbox_changes · sync_emails · get_index_status · search_indexed_emails · clear_cache · clear_index · get_logs

Операционные примечания

• get_emails и search_emails возвращают составной emailId — используйте его для чтения и действий.

• Локальный индекс находится в PROTONMAIL_DATA_DIR/mail-index.sqlite.

• Журналы аудита находятся в PROTONMAIL_DATA_DIR/audit.log.

• Фоновая синхронизация и IMAP IDLE поддерживают индекс в актуальном состоянии, но зависят от работы Bridge.

• search_indexed_emails поддерживает сокращения from:, to:, subject:, label:, domain:.

• Синхронизация черновиков выполняется по принципу «лучших усилий» — локальный черновик всегда сохраняется, даже если удаленная синхронизация не удалась.

Лицензия

MIT