# your-mail-mcp

Локальный сервер для поиска по письмам из IMAP-ящиков без права на запись. Помогает переносить договорённости, пароли и инвойсы прямо в контекст ассистента.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Автор: wildsurfer
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/wildsurfer/your-mail-mcp
- Обновлён: 2026-10-05
- HTML: https://affpapa.org/nevibecode/mcp/your-mail-mcp

## Что делает

Сервер зеркалирует нужные IMAP-аккаунты через `mbsync` и строит локальный индекс поисковиком `notmuch`. Когда ассистент обращается к инструменту, ответ формируется по готовой базе maildir. Подключение работает через стандартный ввод-вывод или локальный веб-шлюз.

Архитектура блокирует любые изменения на сервере провайдера. В коде нет логики для отправки или удаления сообщений. Приложение на Go связывается с почтовым сервером только командой `LIST`, чтобы определить имена служебных каталогов для спама и корзины.

Для запуска обязателен Docker. Учтите параметры почтовых провайдеров: в Gmail понадобится пароль приложения вместе с двухфакторной аутентификацией, а для iCloud логином служит имя без окончания `@icloud.com`.

## Требования
- Нужно: Docker
- Переменные окружения: `PUBLIC_URL`, `OAUTH_PASSPHRASE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- находить пароли, коды доступа и бронирования в архиве почты
- выгружать требования заказчика из переписки в текущую сессию кодинга
- собирать хронологию договорённостей по цепочке сообщений
- просматривать входящую почту без риска случайно отправить ответ

## Примеры запросов агенту
- Найди в архиве писем код подтверждения бронирования за прошлый месяц.
- Вытащи из недавней переписки с клиентом требования к верстке страниц.
- Сделай сводку по новым рабочим письмам, пришедшим за ночь.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md