Thunderbird MCP
Расширение для Thunderbird и MCP-мост: агент ищет письма, пишет черновики, ведет фильтры, контакты и календари, 49 инструментов
- 443 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает письма, вложения, контакты и календарь, а в них бывают личные и деловые данные
- Инструменты удаляют письма и папки, очищают корзину и спам, правят фильтры и контакты, а прямая отправка писем включается настройкой
- Параметр «слушать все интерфейсы» открывает сервер каждому устройству в локальной сети, токен сеанса остается обязательным
Установка
- Работает в
Ручная установка
git clone https://github.com/TKasperczyk/thunderbird-mcp.gitВ репозитории лежит готовый файл dist/thunderbird-mcp.xpi. Установите его в Thunderbird через «Инструменты», «Дополнения», «Установить из файла» и перезапустите программу.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает письма, вложения, контакты и календарь, а в них бывают личные и деловые данные
- Инструменты удаляют письма и папки, очищают корзину и спам, правят фильтры и контакты, а прямая отправка писем включается настройкой
- Параметр «слушать все интерфейсы» открывает сервер каждому устройству в локальной сети, токен сеанса остается обязательным
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Thunderbird MCP дает агенту доступ к почтовому клиенту Thunderbird. Внутри Thunderbird работает расширение со встроенным HTTP-сервером на localhost, а Node-мост `mcp-bridge.cjs` переводит протокол MCP по stdio в запросы к этому серверу и сам находит порт и токен по файлу подключения. Инструментов 49, и они делятся на группы. Почта: поиск по теме, отправителю, получателю, дате и меткам, чтение письма в виде Markdown, текста или HTML, заголовки целиком, поиск вложений, пометки, перенос, копирование, удаление, создание и переименование папок, сохраненные поиски. Составление писем: новое письмо, ответ и пересылка, черновик с вложениями и отложенной отправкой, предварительная проверка без отправки. Еще агент управляет фильтрами, контактами, календарями, событиями и задачами. По умолчанию безопасность стоит выше удобства. Отправка, ответ, пересылка и создание события открывают окно на проверку, и прямая отправка блокируется настройкой «Block skipReview», пока вы сами ее не выключите. Доступ можно ограничить по учетным записям и по каждому инструменту, запись в контакты по умолчанию выключена, чтение зашифрованных писем тоже.
Для кого. Для тех, кто ведет почту, календарь и контакты в Thunderbird и хочет поручить агенту разбор ящика, поиск писем и подготовку ответов с проверкой перед отправкой.
Подходит, если
- Нужно найти письма по отправителю, теме и периоду в большом ящике и получить краткую выжимку с источником
- Нужно подготовить ответ или пересылку с цитатой и правильными заголовками цепочки и проверить текст в окне перед отправкой
- Нужно разобрать входящие: пометить, разложить по папкам, удалить рассылки, настроить правила фильтров
- Нужно найти письма с вложением по имени файла или типу и сохранить вложение на диск
- Нужно посмотреть расписание или создать событие и задачу в календаре Thunderbird с подтверждением в диалоге
Не подходит, если
- Вы не пользуетесь Thunderbird: расширению нужен запущенный клиент версии 128 или новее
- Нужна автоматическая рассылка без проверки человеком: прямая отправка по умолчанию заблокирована
- Нужна работа на сервере без графического клиента: Thunderbird должен быть запущен на вашем компьютере
- Часть почты нельзя показывать модели: инструмент читает письма и вложения всех ящиков, которые вы не исключили в настройках
Пример запроса к агенту
Найди письма от бухгалтерии за последний месяц с вложениями PDF, составь список и подготовь ответ с вопросом по счету в окне, не отправляяMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
THUNDERBIRD_MCP_CONNECTION_FILE- Путь к connection.json, если окружение использует нестандартный каталог временных файлов
Ограничения
Расширению нужен запущенный Thunderbird 128 или новее, а мосту Node. Сервер по умолчанию слушает только localhost на портах 8765–8774, токен сеанса лежит в файле `connection.json` с правами 0600. Параметр «слушать все интерфейсы» открывает сервер всей локальной сети, включайте его только в доверенной сети.
В папках IMAP бывают устаревшие данные, пока вы не откроете папку в Thunderbird. Письма только в HTML превращаются в обычный текст, и форматирование теряется. Операции с папками IMAP асинхронны, результат проверяйте через `listFolders`. Поиск по телу работает через индекс Gloda и без офлайн-синхронизации ищет только по заголовкам. Чтение письма ограничено 50 МБ и 120 секундами. Расширение ставится из файла xpi без подписи, поэтому профиль, где подписи обязательны, блокирует и ручную, и автоматическую установку.
Как отключить. Уберите запись `thunderbird-mail` из конфигурации MCP-клиента, например из `~/.claude.json`. В Thunderbird отключите или удалите расширение в «Инструменты», «Дополнения и темы». Отдельные инструменты и учетные записи отключаются на странице настроек расширения.
Частые вопросы
Как подключить Thunderbird MCP к Claude Code?
Склонируйте репозиторий и установите `dist/thunderbird-mcp.xpi` в Thunderbird (Инструменты, Дополнения, Установить из файла), затем перезапустите программу. В `~/.claude.json` добавьте сервер `thunderbird-mail` с командой `node` и абсолютным путем к `mcp-bridge.cjs`.
Отправит ли агент письмо без моего ведома?
Нет. По умолчанию настройка «Block skipReview» включена, и каждая отправка, ответ и пересылка открывают окно на проверку. Прямая отправка включается только вами в настройках расширения, а для отправителей с включенным шифрованием отклоняется и после этого.
Можно ли ограничить, какие ящики видит агент?
Да. На странице настроек расширения задается список доступных учетных записей, а каждый инструмент можно отключить отдельно. Когда включено ограничение по учетным записям, календари и адресные книги закрыты, пока вы не разрешите их.
Читает ли агент зашифрованные письма?
По умолчанию нет. Пока параметр чтения зашифрованных писем выключен, зашифрованные и закрыто подписанные письма остаются нерасшифрованными. Поиск вложений их тоже не раскрывает.
Что делать, если не хватает свежих писем?
Папки IMAP могут отставать. Откройте папку в Thunderbird или запустите `refreshFolder`. При необходимости сделайте папку доступной офлайн, чтобы работал поиск по телу письма.
Какой порт использует сервер?
Он пробует порты с 8765 по 8774 и записывает выбранный в файл `connection.json`. Мост находит его сам. Если порт 8765 занят, например AnkiConnect, сервер возьмет другой.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыthunderbird-cli дает агенту почту Thunderbird через CLI tb и MCP из 12 инструментов, пароли остаются в Thunderbird
MCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
imap-mcp-server — почта по IMAP и SMTP для агента
imap-mcp-server
MCP-сервер дает агенту искать, читать, отправлять и чистить письма в нескольких ящиках, а пароли хранит под шифрованием AES-256
MCP-сервер к почте на Mac: агент читает, ищет, пишет, сортирует письма и разбирает ящик, есть режим только для чтения
MCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков
MCP-сервер для Apple Mail на macOS: 8 инструментов чтения и поиск по телу писем через индекс FTS5 на больших ящиках
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Thunderbird MCP (эта карточка) | нет | API-ключ | 443 | |
| MCP-сервер Яндекс Почты | нет | API-ключ | 0 | рабочая почта Яндекса по IMAP: чтение, поиск цепочек и черновики, без клиента, календаря и фильтров |
| outlook-mcp | нет | OAuth | 455 | почта, календарь и файлы OneDrive через облачный сервис Microsoft |
Коротко о README
Описание начинается с обоснования: у Thunderbird нет официального API для ИИ-инструментов. Дальше идут схема моста, таблицы всех инструментов по группам с подробностями ограничений и разделы об управлении доступом и безопасности. Установка занимает два шага, в конце приведены советы по неполадкам, структура проекта и известные проблемы.