# Apple Mail

Даёт агенту доступ к Apple Mail на macOS: читать, искать, писать и отправлять письма прямо из чата.

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

## Что делает

Сервер поднимается локально на вашем Mac и отдаёт клиенту инструменты для работы с почтой: поиск по отправителю или теме, чтение переписки, черновики и отправка. Есть отдельные средства для тредов — `mail_get_thread`, `mail_reply_latest_in_thread`, `mail_archive_thread`. Если адрес получателя неизвестен, контакты стоит уточнить заранее: отправка вслепую по догадке — плохая идея.

Нужны macOS и Python 3.11+. Установка идёт через `uvx`, поэтому сначала поставьте `uv`. Профиль безопасности задаётся переменной `APPLE_MAIL_MCP_SAFETY_PROFILE`: для `uvx` и `pip` по умолчанию это `safe_manage`, а в бандлах для Claude Desktop — `full_access`. Пустое или неверное значение переключает сервер в `safe_readonly`, и часть инструментов перестанет работать. Вложения выключены, пока не задан `APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT` с отдельной папкой.

Данные не остаются только на вашем Mac: клиент может передать их провайдеру модели, а Apple-приложения синхронизируются через iCloud или другую учётную запись. Транспорт по умолчанию — `stdio`. Если включаете Streamable HTTP, сервер принимает только `127.0.0.1`, `::1` или `localhost`: удалённой аутентификации нет, и наружу его выставлять нельзя. Разрешения в macOS придётся подтвердить самому — в системном запросе или в настройках.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `APPLE_MAIL_MCP_SAFETY_PROFILE`, `APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT`, `APPLE_MAIL_MCP_VISIBLE_DRAFTS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env APPLE_MAIL_MCP_SAFETY_PROFILE=<APPLE_MAIL_MCP_SAFETY_PROFILE> --env APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT> --env APPLE_MAIL_MCP_VISIBLE_DRAFTS=<APPLE_MAIL_MCP_VISIBLE_DRAFTS> --transport stdio applemail-mcp -- uvx apple-mcp-mail
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>

### Codex

**Командой платформы**
```bash
codex mcp add applemail-mcp --env APPLE_MAIL_MCP_SAFETY_PROFILE=<APPLE_MAIL_MCP_SAFETY_PROFILE> --env APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT> --env APPLE_MAIL_MCP_VISIBLE_DRAFTS=<APPLE_MAIL_MCP_VISIBLE_DRAFTS> -- uvx apple-mcp-mail
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "applemail-mcp": {
            "command": "uvx",
            "args": [
                "apple-mcp-mail"
            ],
            "env": {
                "APPLE_MAIL_MCP_SAFETY_PROFILE": "<APPLE_MAIL_MCP_SAFETY_PROFILE>",
                "APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT>",
                "APPLE_MAIL_MCP_VISIBLE_DRAFTS": "<APPLE_MAIL_MCP_VISIBLE_DRAFTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "applemail-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "apple-mcp-mail"
            ],
            "env": {
                "APPLE_MAIL_MCP_SAFETY_PROFILE": "<APPLE_MAIL_MCP_SAFETY_PROFILE>",
                "APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT>",
                "APPLE_MAIL_MCP_VISIBLE_DRAFTS": "<APPLE_MAIL_MCP_VISIBLE_DRAFTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e APPLE_MAIL_MCP_SAFETY_PROFILE=<APPLE_MAIL_MCP_SAFETY_PROFILE> -e APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT> -e APPLE_MAIL_MCP_VISIBLE_DRAFTS=<APPLE_MAIL_MCP_VISIBLE_DRAFTS> applemail-mcp uvx apple-mcp-mail
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>

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

## Примеры запросов агенту
- Найди в Apple Mail письма от бухгалтерии за прошлую неделю
- Прочитай тред по теме «договор» и ответь на последнее письмо
- Отправь черновик с адреса `work@example.com`

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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