your-mail-mcp
your-mail-mcp
Ваша почта уже содержит ответы: коды бронирования, коды доступа к Wi-Fi, счета, гарантийные сроки, обещания, данные в письменном виде. Этот сервер позволяет вашему ИИ-ассистенту находить их.
Спрашивайте его о таких вещах, как:
«Найди код бронирования для июньского парома.»
«Какой пароль от Wi-Fi прислал отель прошлым летом?»
«Что ответил бухгалтер по поводу НДС и когда?»
«Собери всю переписку между мной и строителем о крыше в хронологическом порядке и резюмируй, кто что обещал.»
«Что пришло сегодня утром на все мои аккаунты, что действительно требует моего внимания?»
Используйте его для:
Поиска, который понимает вопросы. Полнотекстовый поиск по всей вашей истории, по всем аккаунтам в одном индексе, сформулированный так, как вы думаете, а не так, как требует синтаксис поиска.
Сортировки со смартфона. Утренняя сводка того, что пришло, с уже отфильтрованным спамом, откуда бы вы ни находились.
Почты как контекста для другой работы. Извлечение требований клиента из переписки и перенос их в вашу сессию кодинга или написания текстов, вместо того чтобы перепечатывать их.
Агентов, которые можно оставить работать. Сервер может только читать. Вредоносное письмо, дошедшее до вашего ассистента, будет только прочитано, потому что отправка, удаление и перемещение здесь не существуют. Это делает запланированные дайджесты и постоянно работающих агентов спокойной задачей.
Настройка — это два файла и docker compose up -d — см. Запуск.
Самодельный MCP-сервер, который даёт MCP-клиенту (Claude или любому другому клиенту, поддерживающему потоковый HTTP MCP с OAuth) доступ на чтение к вашей почте. Он зеркалирует одну или несколько IMAP-учёток в локальный maildir с помощью mbsync, индексирует их с помощью notmuch и отвечает на вызовы инструментов из этого индекса.

Почта движется только слева направо на этой схеме. Единственная стрелка от сервера обратно к провайдеру — это один IMAP-LIST при запуске, чтобы узнать, как провайдер называет свои папки спама и корзины; сервер никогда не открывает почтовый ящик и не загружает сообщения. Исходник схемы:
docs/diagrams/how-it-works.html
Чего он не может
Свойство «только чтение» заложено в архитектуру.
Зеркалирование работает только на загрузку. Сгенерированная конфигурация mbsync для каждой учётки содержит Sync Pull, Create Near, Remove None, Expunge None — ничто в этой конфигурации не может отправить изменение обратно на сервер, удалить сообщение или выполнить экспунг.
Единственная операция IMAP в коде на Go — это LIST, выполняемая один раз для каждой учётки при запуске, чтобы найти папки спама и корзины (см. Примечания по провайдерам и Устранение неполадок). Это соединение входит в систему, получает список папок и выходит. Оно никогда не открывает почтовый ящик и не загружает сообщения.
Здесь нет отправки, удаления, перемещения и меток. Вложения перечисляются в show и thread и отдаются только на чтение инструментом attachment, по одной части за раз, с ограничением 5 МБ. Части большего размера отдаются в сыром виде по адресу GET /attachment/{id}/{part}, с аутентификацией по bearer-токену или по короткоживущей подписанной ссылке, которую инструмент возвращает, когда отказывается отдавать слишком большой файл. Ничто в процессе не имеет права записи ни к одной учётке.
Десять инструментов, все только на чтение:
Инструмент | Что делает |
| Поиск почты. Возвращает сводки обсуждений в формате JSON. |
| Возвращает идентификаторы сообщений, соответствующих запросу. |
| Возвращает пути к файлам maildir, соответствующие запросу. |
| Подсчитывает сообщения, соответствующие запросу. |
| Показывает одно сообщение: заголовки и декодированное тело, в формате JSON. |
| Показывает всю ветку обсуждения, содержащую сообщение. По умолчанию исключает ответы из спама/корзины; установите |
| Возвращает текстовое тело одного сообщения с преобразованием HTML. |
| Перечисляет учётки, их папки, теги индекса, а также время последней синхронизации и последнюю ошибку для каждой учётки. |
| Синхронизирует «Входящие» сейчас и сообщает, сколько сообщений пришло. |
| Одно вложение или MIME-часть сообщения, по номеру части из |
search, ids, files и count принимают запрос notmuch (from:, to:, subject:, tag:, folder:, date:2026-01-01..2026-06-30, с комбинациями and/or/not), необязательный параметр account для ограничения одной учёткой и могут включать спам/корзину с помощью include_excluded.
Related MCP server: notmuchproxy
Запуск
Есть три способа запуска. Они отличаются одним: кто может получить доступ к серверу. Начните со случая 1 и переходите дальше только когда понадобится. Ни один из них не защищён сильнее, чем настройки по умолчанию — об этом см. Усиление защиты ниже; это сознательно вынесено отдельно, чтобы вы могли сначала запустить систему.
Где работает | Кто может получить доступ | Где хранится ваша почта | |
1 | ваша машина | только эта машина | ваша машина |
2 | ваша машина | вы, откуда угодно | ваша машина |
3 | VPS | вы, откуда угодно | арендованный диск |
Сервер поставляется в виде контейнерного образа на ghcr.io/wildsurfer/your-mail-mcp, собирается и публикуется CI для amd64 и arm64. Ничего компилировать не нужно, и каждый случай начинается одинаково — с двух файлов в пустой директории:
mkdir your-mail && cd your-mail
curl -fsSLO https://raw.githubusercontent.com/wildsurfer/your-mail-mcp/main/compose.yaml
curl -fsSL https://raw.githubusercontent.com/wildsurfer/your-mail-mcp/main/accounts.example.json -o accounts.jsonОтредактируйте accounts.json, указав свои учётки (см. Файл accounts), затем поместите секреты, на которые он ссылается, в файл .env рядом с compose.yaml:
# .env
OAUTH_PASSPHRASE=pick-a-long-one-you-can-type-on-a-smartphone
WORK_PASS=your-gmail-app-password
PERSONAL_PASS=your-icloud-app-specific-passwordOAUTH_PASSPHRASE — единственный секрет между интернетом и вашей почтой в случаях 2 и 3. Относитесь к нему соответственно.
Эти два файла содержат пароли от вашей почты. Если вы когда-нибудь поместите эту директорию под контроль версий или в резервную копию, которая покинет машину, относитесь к ним соответственно.
Случай 1 — на вашей машине, только для вашей машины
Сервер привязывается к loopback. Ничто за пределами вашей машины не может до него добраться, поэтому не нужно настраивать TLS и владеть доменом. Ваши CLI-инструменты могут им пользоваться. Ваш смартфон — нет.
Добавьте одну строку в .env:
PUBLIC_URL=http://127.0.0.1:8080Затем запустите:
docker compose up -d
docker compose logs -f # watch the first syncПервая синхронизация заполняет maildir и занимает время на большом почтовом ящике. Она намеренно медленная — одна команда IMAP за раз, потому что провайдеры ограничивают частоту запросов. Отдельного шага инициализации нет.
Claude Code
claude mcp add --transport http your-mail http://127.0.0.1:8080/mcpЗатем выполните /mcp внутри Claude Code, выберите your-mail и пройдите аутентификацию. Браузер откроет страницу согласия, которая запросит одно: ваш OAUTH_PASSPHRASE. Пока вы этого не сделаете, claude mcp list будет показывать Needs authentication.
Codex
codex mcp add your-mail --url http://127.0.0.1:8080/mcp
codex mcp login your-mailcodex mcp list показывает статус аутентификации. Если инструменты так и не появляются в сессии после успешного входа, это известный баг Codex, при котором учётные данные OAuth получаются, но затем никогда не используются (openai/codex#20009). Используйте обходной мост ниже, пока это не исправят.
mcp-remote сам выполняет процедуру OAuth и повторно открывает сервер через stdio, который поддерживает любой MCP-клиент:
# ~/.codex/config.toml
[mcp_servers.your-mail]
command = "npx"
args = ["-y", "mcp-remote", "http://127.0.0.1:8080/mcp"]При первом запуске он открывает ту же страницу согласия и кэширует токены.
Случай 2 — на вашей машине, доступен откуда угодно
Тот же сервер плюс что-то, что даёт ему публичный HTTPS-адрес. Ваша почта остаётся на вашей машине, и ничто не слушает вашу домашнюю сеть, потому что туннель устанавливает исходящее соединение. Это нужно для приложений на смартфоне и десктопе: пользовательский коннектор загружается серверами вендора, поэтому они не могут обратиться к частному адресу.
С Tailscale (домен не нужен)
Одна команда, одинаковая на macOS и Linux, и вы получаете HTTPS-имя хоста без необходимости владеть доменом.
tailscale funnel --bg 8080--bg поддерживает его работу после перезагрузок. Он выводит публичный URL, который выглядит как https://your-machine.your-tailnet.ts.net. Это имя хоста, которое нужно использовать:
# .env
PUBLIC_URL=https://your-machine.your-tailnet.ts.netdocker compose up -dFunnel требует сертификаты HTTPS и включённый атрибут узла Funnel для вашей tailnet; CLI предложит добавить строку политики при первом запуске, а остальное — в вашей админ-консоли. tailscale funnel status показывает, что открыто наружу, а tailscale funnel --https=443 off закрывает доступ.
С Cloudflare (у вас есть домен, и он на Cloudflare)
Используйте это, если хотите имя хоста на своём домене, а не на .ts.net. mail.example.com ниже — ваш домен, уже добавленный в вашу учётную запись Cloudflare — Cloudflare не выдаёт вам имя хоста для именованного туннеля.
cloudflared tunnel login
cloudflared tunnel create your-mailcreate выводит UUID туннеля и файл с учётными данными, который он только что записал:
Tunnel credentials written to /Users/you/.cloudflared/f9e2…-… .json
Created tunnel your-mail with id f9e2…-…Используйте этот точный путь ниже; cloudflared tunnel list снова выведет UUID, если вы его потеряете. Направьте имя хоста, затем напишите ~/.cloudflared/config.yml:
cloudflared tunnel route dns your-mail mail.example.comtunnel: your-mail
credentials-file: /Users/you/.cloudflared/f9e2….json # the path create printed
url: http://localhost:8080cloudflared tunnel run your-mailЧтобы он работал постоянно: на Linux — sudo cloudflared service install. На macOS установите его через Homebrew и используйте brew services start cloudflared, потому что путь установки через sudo ищет сертификат в домашней директории root-пользователя и не найдёт тот, что cloudflared tunnel login записал в вашу.
Затем установите PUBLIC_URL=https://mail.example.com в .env и выполните docker compose up -d.
В любом случае
PUBLIC_URL должен точно совпадать с тем, что вы вводите в клиенте. Сервер публикует PUBLIC_URL + /mcp как resource в своих OAuth-метаданных, и несовпадение здесь — самая частая причина, по которой коннектор отказывается добавляться.
Одна вещь, которую стоит знать перед началом работы на смартфоне: ни Claude, ни ChatGPT не позволяют добавить коннектор из приложения на смартфоне. Вы добавляете его один раз в вебе (или в десктопном приложении Claude), и затем он появляется на вашем смартфоне. Попытка настроить всё прямо на смартфоне — пустая трата времени.
Claude — добавьте в вебе или на десктопе, затем пользуйтесь на смартфоне
На claude.ai или в Claude Desktop перейдите в Settings → Connectors и нажмите + рядом с Connectors или Add custom connector.
Дайте ему имя и URL
<PUBLIC_URL>/mcp. Поля расширенного OAuth оставьте пустыми: этот сервер регистрирует клиентов динамически.Claude откроет страницу согласия. Введите ваш
OAUTH_PASSPHRASE.Откройте приложение Claude на смартфоне. Коннектор уже там, и инструменты доступны в чате. Включите его для разговора через меню инструментов или коннекторов в композере.
ChatGPT — добавьте в вебе, затем пользуйтесь на смартфоне
Пользовательские MCP-коннекторы находятся за режимом разработчика, для которого нужна учетная запись Pro, Plus, Business, Enterprise или Education, и доступны только в веб-версии.
В ChatGPT в веб-версии откройте Настройки → Безопасность и вход и включите Режим разработчика. В рабочих пространствах Business и Enterprise администратор может сначала разрешить это.
Добавьте коннектор для удаленного MCP-сервера и укажите URL
<PUBLIC_URL>/mcpс аутентификацией OAuth. ChatGPT поддерживает динамическую регистрацию клиентов, так что вставлять ничего не нужно.Подтвердите страницу согласия с помощью
OAUTH_PASSPHRASE.Откройте ChatGPT на смартфоне и включите коннектор в чате.
Эти меню перемещаются. Если указанные выше названия не совпадают с тем, что вы видите, ищите режим разработчика в настройках, а затем место, где добавляется коннектор по URL.
ChatGPT отключает некоторые операции записи MCP на мобильных устройствах. На это не влияет, потому что у этого сервера вообще нет операций записи.
Claude Code
claude mcp add --transport http your-mail https://your-host/mcpCodex
codex mcp add your-mail --url https://your-host/mcp
codex mcp login your-mailСлучай 3 — на VPS, доступном откуда угодно
Выбирайте это, если хотите, чтобы зеркало оставалось активным независимо от того, включен ли ваш компьютер. Это стоит несколько долларов в месяц и один реальный компромисс: полная копия вашей почты в открытом виде перемещается на арендованный диск, а пароли приложений находятся в том же окружении. Прочтите Безопасность, прежде чем выбирать это.
Установка — это случай 1 плюс туннель на чужом компьютере. Никаких портов открывать не нужно, DNS настраивать не нужно, сертификатами управлять не нужно.
На свежем Debian или Ubuntu:
# 1. Docker
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER && newgrp docker
# 2. The two files, and your accounts
mkdir your-mail && cd your-mail
curl -fsSLO https://raw.githubusercontent.com/wildsurfer/your-mail-mcp/main/compose.yaml
curl -fsSL https://raw.githubusercontent.com/wildsurfer/your-mail-mcp/main/accounts.example.json -o accounts.json
$EDITOR accounts.json # your accounts
$EDITOR .env # OAUTH_PASSPHRASE and the account passwords
# 3. A public address, exactly as in case 2
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale funnel --bg 8080 # prints your https://….ts.net hostname
# 4. Put that hostname in .env, then start
echo "PUBLIC_URL=https://your-machine.your-tailnet.ts.net" >> .env
docker compose up -d
docker compose logs -fPUBLIC_URL указывается последним, потому что имя хоста неизвестно, пока шаг 3 не выведет его.
Подключение клиента идентично случаю 2.
restart: unless-stopped в compose.yaml возвращает контейнеры после перезагрузки. Проверяйте с помощью инструмента folders, который сообщает о последней синхронизации каждой учетной записи и последней ошибке, или с помощью docker compose logs --tail=50.
Теперь перейдите к разделу Укрепление. VPS, к которому можно подключиться по SSH с паролем и на котором хранится копия вашей почты, хуже, чем вообще не запускать это.
Укрепление
Ничего из этого не требуется для работы сервера, поэтому этого нет в шагах установки. Это упорядочено по тому, сколько выгоды это приносит. Случай 1 не требует ничего из этого.
Выберите настоящую парольную фразу. OAUTH_PASSPHRASE — это вся дверь. Неверное предположение стоит атакующему одну секунду, и попытки сериализованы, так что параллельный запуск не помогает, но ни то, ни другое не спасает короткую парольную фразу. Используйте длинную, которую вы все еще можете ввести на смартфоне.
Ограничьте SSH (случай 3). Арендованный сервер с входом по паролю и копией вашей почты — худшая комбинация в этом документе. От имени root, прежде всего:
adduser mail && usermod -aG sudo mail
rsync --archive --chown=mail:mail ~/.ssh /home/mail
sed -i 's/^#\?PermitRootLogin.*/PermitRootLogin no/; s/^#\?PasswordAuthentication.*/PasswordAuthentication no/' /etc/ssh/sshd_config
systemctl restart sshЗатем выполняйте установку как mail, а не как root.
Закройте неиспользуемые порты (случай 3). С туннелем вам вообще не нужны входящие порты, поэтому:
sudo ufw allow OpenSSH && sudo ufw --force enableОграничьте доступ к коннектору. Если с вашим сервером общается только пользовательский коннектор в приложении Claude, этот трафик поступает из опубликованного диапазона исходящих адресов Anthropic, 160.79.104.0/21, и вы можете отказать всему остальному на туннеле или брандмауэре. Не делайте этого, если вы также используете Claude Code или Codex с ноутбука, поскольку они подключаются откуда угодно.
Создавайте резервные копии томов или соглашайтесь на повторную синхронизацию. compose.yaml хранит maildir и индекс в именованных томах. Ничего в них уникального нет — все это все еще на вашем почтовом сервере — но повторная загрузка большого почтового ящика занимает время и раздражает провайдеров, которые ограничивают скорость.
Знайте, что парольная фраза не защищает. Она ограничивает поверхность MCP. Она не шифрует ничего в состоянии покоя. См. Безопасность.
Если вы предпочитаете завершать TLS самостоятельно на своем домене, укажите запись A на сервер и поставьте Caddy перед ним. Добавьте compose.override.yaml:
services:
caddy:
image: caddy:2
restart: unless-stopped
ports: ["80:80", "443:443"]
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
volumes:
caddy_data:# Caddyfile
mail.example.com {
reverse_proxy your-mail-mcp:8080
}Откройте оба порта — 80 не является необязательным, Caddy использует его для проверки сертификата и перенаправления HTTPS:
sudo ufw allow 80/tcp && sudo ufw allow 443/tcpCaddy получает и продлевает сертификат сам. Установите PUBLIC_URL на имя хоста и выполните docker compose up -d.
Файл учетных записей
Смонтирован только для чтения в /config/accounts.json (см. compose.yaml). JSON, разбирается с помощью encoding/json, перед разбором разворачивается в окружении процесса, так что ${VAR} в любом строковом значении заменяется переменной окружения с таким именем. Так секреты остаются вне файла:
{
"accounts": [
{
"name": "work",
"host": "imap.gmail.com",
"user": "you@example.com",
"password": "${WORK_PASS}"
}
]
}Ключи для каждой учетной записи:
Ключ | По умолчанию | Примечания |
| — | Обязательно. Без пробелов, кавычек или косых черт (прямых или обратных). Становится каталогом верхнего уровня maildir для учетной записи и аргументом |
| — | Обязательно. Имя хоста IMAP-сервера. |
|
| |
| — | Обязательно. См. Примечания к провайдерам: iCloud хочет короткое имя, а не полный адрес электронной почты. |
| — | Обязательно. |
|
|
|
|
| Шаблоны папок mbsync — какие папки зеркалировать. |
| определяется автоматически | Имена папок, исключаемые из поиска по умолчанию (см. обнаружение SPECIAL-USE). Установка этого параметра полностью переопределяет обнаружение для этой учетной записи. |
Имя учетной записи должно быть уникальным. Требуется как минимум одна учетная запись; пустой массив accounts — это ошибка запуска.
Переменные окружения
Переменная | Обязательно | По умолчанию | Значение |
| да | — | Путь к файлу учетных записей. |
| да | — | Корень Maildir; каждая учетная запись получает подкаталог. |
| да | — | Каталог индекса notmuch/Xapian. |
| да | — | Внешний URL, по которому доступен сервер, точно так, как его будет использовать клиент (конечная косая черта, если есть, удаляется). Используется в метаданных OAuth и должен совпадать с тем, что вы вводите в клиенте. |
| да | — | Единственная парольная фраза, которая ограничивает экран согласия. |
| нет |
| Период полной синхронизации, как длительность Go ( |
| нет |
| Предельный срок для одной учетной записи на один запуск mbsync, как длительность Go. Увеличьте его, если большое первое зеркало все еще работает, когда достигает этого и обрывается — почтовый ящик с десятками тысяч сообщений может занять значительно больше времени, чем по умолчанию. |
| нет |
| Адрес, к которому привязывается HTTP-сервер. |
| нет | не задано | Установите в |
CONFIG, MAILDIR и INDEX обязательны; процесс отказывается запускаться без них. PUBLIC_URL и OAUTH_PASSPHRASE требуются уровнем OAuth, и процесс также не запускается без них.
Образ контейнера уже устанавливает четыре из них (Dockerfile): MAILDIR=/mail, INDEX=/index, CONFIG=/config/accounts.json, LISTEN_ADDR=:8080. compose.yaml не переопределяет ни одну из них. Оставьте их в покое, если вы также не меняете соответствующий том или конфигурацию в compose.yaml — переопределение, которое не перемещает точку монтирования вместе с ним, указывает серверу на пустой или отсутствующий путь.
Без Docker
Двоичные файлы релизов для Linux и macOS, amd64 и arm64, находятся на странице релизов с контрольными суммами. Двоичный файл вызывает mbsync, notmuch и w3m, поэтому сначала установите их — brew install isync notmuch w3m на macOS, apt install isync notmuch w3m на Debian и Ubuntu. isync 1.4.4 или новее работает.
Затем та же конфигурация, что и для контейнера, с путями по вашему выбору. Тома контейнера изначально являются точками монтирования, которые защита от пустого maildir воспринимает как настоящий первый запуск; обычный каталог, который вы создаете сами, выглядит точно так же, как отсутствующий том для этой защиты, поэтому ему нужен INIT_MIRROR=1, чтобы указать, что это действительно первый запуск:
mkdir -p mail index
CONFIG=./accounts.json MAILDIR=./mail INDEX=./index INIT_MIRROR=1 \
PUBLIC_URL=http://127.0.0.1:8080 OAUTH_PASSPHRASE=... \
WORK_PASS=... ./your-mail-mcpWindows не поддерживается: обработка maildir опирается на семантику файловой системы Unix, и нет mbsync, к которому можно было бы обратиться.
Сборка самостоятельно
CI собирает, тестирует и публикует каждый образ, так что никому не нужно — но это одна команда, если вы хотите: docker build -t your-mail-mcp . для контейнера или go build для двоичного файла (Go 1.27, с тремя инструментами выше в PATH для тестов).
Примечания к провайдерам
Заметки об iCloud взяты из длительной эксплуатации реального зеркала iCloud, которое предшествует этому серверу. Заметки о Gmail и Dovecot взяты из документации провайдеров и исследований проекта и не все были повторно проверены через этот сервер.
iCloud (
imap.mail.me.com):userдля IMAP — это короткое имя — часть до@icloud.com, а не полный адрес электронной почты. iCloud ограничивает одновременные IMAP-подключения; поэтому сгенерированная конфигурация mbsync фиксируетPipelineDepth 1для каждой учётной записи, и это не настраивается.Gmail (
imap.gmail.com): требуется пароль приложения, а для него нужно сначала включить двухэтапную проверку на учётной записи — Gmail не принимает пароль учётной записи напрямую по IMAP. Gmail также хранит копию практически всего в[Gmail]/All Mail, поэтому зеркало учётной записи Gmail примерно вдвое больше, чем можно предположить по списку папок, поскольку большинство сообщений существуют и в своей папке, и в All Mail. Первое зеркалирование большой учётной записи Gmail занимает часы, а Google также устанавливает ежедневную квоту на загрузку по IMAP (около 2,5 ГБ в день), поэтому многогигабайтный почтовый ящик растягивает первое зеркалирование на несколько дней. Это нормально: сервер продолжает повторять попытки по своему расписанию, а mbsync возобновляет работу с места остановки. УстановитеSYNC_TIMEOUTв значение вроде8hдля первого зеркалирования, чтобы длительный процесс не был прерван часовым дедлайном по умолчанию.Серверы Dovecot (многие самостоятельно размещённые и небольшие провайдеры) обычно добавляют префикс
INBOX.к именам папок (например,INBOX.Sent). Еслиfoldersпоказывает неожиданные имена папок, обычно причина в этом.
Безопасность
Пароли учётных записей передаются через окружение процесса (${VAR} в accounts.json или буквальные значения). При запуске сервер записывает их в сгенерированный файл конфигурации mbsync на диск внутри контейнера с правами доступа 0600. Этот файл не зашифрован. Всё, что может прочитать окружение контейнера или этот файл, может прочитать пароли в открытом виде.
Защита в состоянии покоя — шифрование диска, ограничение того, кто может выполнять команды в контейнере, доступ к хосту — является ответственностью оператора. Этот сервер не заявляет о шифровании учётных данных в состоянии покоя и не пытается этого делать.
Парольная фраза OAuth проверяется за постоянное время и закрывает весь сервер одним общим секретом; это не система учётных данных для каждого пользователя. Относитесь к OAUTH_PASSPHRASE и паролям почтовых учётных записей с той же осторожностью.
Сводки обсуждений в search включают отображаемое имя для каждого сообщения в подходящем обсуждении, и это имя контролируется отправителем. Сообщение в папке, исключённой по умолчанию (junk, trash), может таким образом показать вам выбранное атакующим имя, даже если его тело никогда этого не делает — search не загружает и не показывает тело исключённого сообщения. thread и show — это пути чтения, на которые это не распространяется: thread по умолчанию исключает ответы из junk/trash (см. таблицу инструментов выше), а show читает одно сообщение, для которого у вас уже есть id. Эта утечка отображаемого имени в search не исправлена в данном выпуске.
Устранение неполадок
"maildir ... is an empty plain directory, not a mount point: refusing to sync" — сервер проверяет, является ли ваш maildir смонтированной файловой системой. Смонтированный том, который оказался пустым, — это первый запуск, и он синхронизируется без какого-либо согласия, поэтому для compose не нужен дополнительный шаг. Пустая обычная директория неоднозначна: свежий maildir выглядит точно так же, как путь, чей том никогда не был смонтирован, и синхронизация во вторую директорию заново загружает все учётные записи в каталог, который исчезает в тот момент, когда вы исправляете монтирование. Либо смонтируйте хранилище туда, куда указывает MAILDIR, либо установите INIT_MIRROR=1, если это действительно должна быть обычная директория в этой файловой системе.
"maildir ...: no such file or directory" — путь вообще не существует. При использовании compose это означает, что том или bind-mount отсутствует в compose.yaml; при непосредственном запуске двоичного файла это означает, что MAILDIR указан неверно.
Проверяйте статус синхронизации каждой учётной записи с помощью инструмента folders. Он перечисляет каждую настроенную учётную запись, время её последней успешной синхронизации, последнюю ошибку, если она была, её папки и теги в индексе. Одна учётная запись с неверным паролем или истёкшим паролем приложения не останавливает остальные — сбои синхронизации изолированы для каждой учётной записи — но это будет видно здесь как строка last error, а не как тишина.
Исключение junk/trash: два разных вида сбоев:
"special-use discovery: account NAME: ..." в логах контейнера означает, что подключение, вход или
LISTдля этой учётной записи при запуске полностью завершились неудачей. При таком сбое нет имён папок, по которым можно было бы выполнить сопоставление, поэтому для этой учётной записи не исключается ничего — даже встроенным списком английских названий — пока проблема с подключением не будет устранена или для неё вручную не будет заданexclude_folders.Ошибки нет, но
foldersпо-прежнему не показывает ничего исключённого — это означает, чтоLISTвыполнился успешно — сервер просто не сообщает об атрибутах\Junk/\Trash(нет поддержки RFC 6154 SPECIAL-USE) и имена его папок не совпадают со встроенным списком английских названий (junk,spam,trash,deleted messages,deleted items,bulk mail). Это случай локализованного почтового ящика — например, немецкого или французского — и решение то же: задайтеexclude_foldersвручную.
exclude_folders в accounts.json, например "exclude_folders": ["Papierkorb"], имеет приоритет и над SPECIAL-USE, и над встроенным списком в любом случае.
This server cannot be installed
Maintenance
Related MCP Servers
- AlicenseAqualityBmaintenanceLocal MCP server for multi-account IMAP/SMTP email (iCloud + Gmail via app-specific passwords). Never marks mail read. Cross-folder search, idempotent sends, TLS verified.8MIT
- AlicenseNot gradedqualityBmaintenanceEnables LLMs to search and read email from a notmuch archive, providing tools for searching threads, retrieving messages, and listing tags through an MCP endpoint.MIT
- FlicenseNot gradedqualityCmaintenanceLocal IMAP/SMTP MCP server that lets Claude read, search, draft, send, flag, and move mail across multiple IMAP mailboxes. Credentials stay on your machine.
- FlicenseNot gradedqualityBmaintenanceA private, single-user MCP server that unifies Gmail, Microsoft 365/Outlook, and IMAP mailboxes for LLMs to search and read emails live, without storing or caching mailbox contents.
Related MCP Connectors
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wildsurfer/your-mail-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server