your-mail-mcp — MCP-сервер для Claude Code: функции и установка
Локальный сервер для поиска по письмам из IMAP-ящиков без права на запись. Помогает переносить договорённости, пароли и инвойсы прямо в контекст ассистента.
claude mcp add --env PUBLIC_URL=<PUBLIC_URL> --env OAUTH_PASSPHRASE=<OAUTH_PASSPHRASE> --transport stdio your-mail-mcp -- docker run -i --rm -e PUBLIC_URL -e OAUTH_PASSPHRASE ghcr.io/wildsurfer/your-mail-mcp:0.4.0Что делает your-mail-mcp
Сервер зеркалирует нужные IMAP-аккаунты через mbsync и строит локальный индекс поисковиком notmuch. Когда ассистент обращается к инструменту, ответ формируется по готовой базе maildir. Подключение работает через стандартный ввод-вывод или локальный веб-шлюз.
Архитектура блокирует любые изменения на сервере провайдера. В коде нет логики для отправки или удаления сообщений. Приложение на Go связывается с почтовым сервером только командой LIST, чтобы определить имена служебных каталогов для спама и корзины.
Для запуска обязателен Docker. Учтите параметры почтовых провайдеров: в Gmail понадобится пароль приложения вместе с двухфакторной аутентификацией, а для iCloud логином служит имя без окончания @icloud.com.
Какие задачи решает
- находить пароли, коды доступа и бронирования в архиве почты
- выгружать требования заказчика из переписки в текущую сессию кодинга
- собирать хронологию договорённостей по цепочке сообщений
- просматривать входящую почту без риска случайно отправить ответ
Примеры запросов агенту
- Найди в архиве писем код подтверждения бронирования за прошлый месяц.
- Вытащи из недавней переписки с клиентом требования к верстке страниц.
- Сделай сводку по новым рабочим письмам, пришедшим за ночь.
Как установить your-mail-mcp
Командой платформы
claude mcp add --env PUBLIC_URL=<PUBLIC_URL> --env OAUTH_PASSPHRASE=<OAUTH_PASSPHRASE> --transport stdio your-mail-mcp -- docker run -i --rm -e PUBLIC_URL -e OAUTH_PASSPHRASE ghcr.io/wildsurfer/your-mail-mcp:0.4.0Вместо <…> подставьте свои значения
Командой платформы
codex mcp add your-mail-mcp --env PUBLIC_URL=<PUBLIC_URL> --env OAUTH_PASSPHRASE=<OAUTH_PASSPHRASE> -- docker run -i --rm -e PUBLIC_URL -e OAUTH_PASSPHRASE ghcr.io/wildsurfer/your-mail-mcp:0.4.0Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"your-mail-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PUBLIC_URL",
"-e",
"OAUTH_PASSPHRASE",
"ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
],
"env": {
"PUBLIC_URL": "<PUBLIC_URL>",
"OAUTH_PASSPHRASE": "<OAUTH_PASSPHRASE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"your-mail-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PUBLIC_URL",
"-e",
"OAUTH_PASSPHRASE",
"ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
],
"env": {
"PUBLIC_URL": "<PUBLIC_URL>",
"OAUTH_PASSPHRASE": "<OAUTH_PASSPHRASE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PUBLIC_URL=<PUBLIC_URL> -e OAUTH_PASSPHRASE=<OAUTH_PASSPHRASE> your-mail-mcp docker run -i --rm -e PUBLIC_URL -e OAUTH_PASSPHRASE ghcr.io/wildsurfer/your-mail-mcp:0.4.0Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о your-mail-mcp
Как установить your-mail-mcp в Claude Code?
Выполните команду `claude mcp add --env PUBLIC_URL=<PUBLIC_URL> --env OAUTH_PASSPHRASE=<OAUTH_PASSPHRASE> --transport stdio your-mail-mcp -- docker run -i --rm -e PUBLIC_URL -e OAUTH_PASSPHRASE ghcr.io/wildsurfer/your-mail-mcp:0.4.0`. Убедитесь, что передали нужные переменные окружения.
Чем your-mail-mcp отличается от обычных почтовых плагинов?
Сервер работает строго в режиме чтения и не может отправлять или удалять письма. Вся почта индексируется локально через notmuch, поэтому запросы ассистента не обращаются к внешним серверам напрямую.
Что нужно настроить для работы с ящиками Gmail и iCloud?
Для Gmail потребуется создать пароль приложения при включённой двухфакторной аутентификации. Для iCloud в конфигурации accounts.json нужно указать короткий логин без окончания @icloud.com.
