jmap-mcp
MCP-сервер для почты по протоколу JMAP: поиск, чтение, пометки, перенос и отправка писем в Fastmail и Stalwart из агента
- 179 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент читает личную почту, а токен открывает весь ящик
- Инструменты `send_email` и `reply_to_email` отправляют настоящие письма от вашего имени
- `delete_emails` удаляет письма окончательно, без корзины
Установка
- Работает в
Ручная установка
/plugin marketplace add wyattjoh/claude-code-marketplace
/plugin install jmap-mcp@wyattjoh-marketplaceРекомендуемый способ из README. Затем задайте JMAP_SESSION_URL и JMAP_BEARER_TOKEN.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает личную почту, а токен открывает весь ящик
- Инструменты `send_email` и `reply_to_email` отправляют настоящие письма от вашего имени
- `delete_emails` удаляет письма окончательно, без корзины
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
jmap-mcp подключает агента к почтовому серверу по JMAP, современной замене IMAP на JSON и HTTP. Работает с Fastmail, Cyrus IMAP и Stalwart Mail Server. Поиск писем сочетает текст, отправителя, получателя, тему, ящик, ключевые слова и диапазон дат, а `get_emails` подгружает только нужные свойства, чтобы не раздувать контекст. Среди инструментов `get_mailboxes`, `get_threads`, `mark_emails`, `move_emails`, `patch_email_mailboxes` и `delete_emails`. Для опроса есть инкрементальная синхронизация: `get_email_changes` и `get_search_updates` возвращают только изменения с прошлого состояния. Отправка и ответ с заголовками и ответом всем вынесены в отдельные инструменты. Сервер собран на Deno и состоит из двух пакетов: клиента `@wyattjoh/jmap` на jmap-jam, который подходит для отдельных приложений, и MCP-слоя поверх него. Регистрация инструментов зависит от возможностей: чтение и отправка включаются раздельно.
Для кого. Владельцам ящиков на Fastmail или собственном JMAP-сервере, которые хотят разбирать почту с помощью Claude Code без IMAP.
Подходит, если
- Входящие надо разобрать: найти письма от поставщика за месяц и отметить прочитанными
- Нужен список непрочитанных в ящике inbox и короткая сводка по каждому
- Агент опрашивает ящик и должен брать только то, что изменилось с прошлой проверки
- Цепочку писем по теме нужно собрать целиком по идентификатору треда
- Ответ на письмо готовится агентом с корректными заголовками и ответом всем
Не подходит, если
- Почтовый сервер работает только по IMAP и SMTP: нужен другой сервер, например email-mcp
- Ящик на Gmail или Яндекс Почте, где JMAP не предусмотрен
- Агент должен только читать, а выдавать токен без права отправки нельзя
- Deno 2 не установлен и ставить его нет возможности
Пример запроса к агенту
Найди непрочитанные письма от бухгалтерии за последнюю неделю и выведи тему и первую строку каждого.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
JMAP_SESSION_URLобязательная- Адрес сессии JMAP-сервера, обычно оканчивается на /.well-known/jmap
JMAP_BEARER_TOKENобязательная, секрет- Токен доступа для входа на JMAP-сервер
JMAP_ACCOUNT_ID- Идентификатор аккаунта, определяется сам, если не задан
Ограничения
- Нужен Deno версии 2 или новее и JMAP-сервер с действующими учетными данными: адрес сессии и токен доступа.
- Права `--allow-net` ограничьте адресом вашего сервера: в примере стоит api.fastmail.com.
- `delete_emails` удаляет письма окончательно, а `send_email` и `reply_to_email` отправляют настоящие письма.
- Поиск возвращает только идентификаторы, содержимое подгружается отдельным вызовом `get_emails`.
Как отключить. В Claude Code выполните `/plugin uninstall jmap-mcp@wyattjoh-marketplace`. Если ставили вручную, удалите блок jmap из конфигурации MCP и отзовите токен в почтовом сервисе.
Частые вопросы
Что такое JMAP и чем он отличается от IMAP?
JMAP — почтовый протокол на JSON поверх HTTP по RFC 8620 и 8621. Он отдает изменения с прошлого состояния и проще для скриптов, а сервер jmap-mcp работает только с ним и IMAP не понимает.
Как поставить jmap-mcp в Claude Code?
Выполните `/plugin marketplace add wyattjoh/claude-code-marketplace` и `/plugin install jmap-mcp@wyattjoh-marketplace`, затем задайте JMAP_SESSION_URL и JMAP_BEARER_TOKEN в настройках сервера.
Какие переменные окружения нужны?
Обязательные две: JMAP_SESSION_URL с адресом сессии сервера и JMAP_BEARER_TOKEN с токеном. Необязательная JMAP_ACCOUNT_ID задает аккаунт, иначе сервер определяет его сам.
Как не дать агенту отправлять письма?
Регистрация инструментов зависит от возможностей токена: чтение и отправка включаются раздельно. Выдайте токен без права отправки и ограничьте `--allow-net` адресом сервера.
Какие почтовые серверы подходят?
Любой с JMAP по RFC 8620 и 8621: в README названы Fastmail, Cyrus IMAP и Stalwart Mail Server. Для другого хоста замените его в `--allow-net` и адрес сессии.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыНеофициальный MCP-сервер Fastmail: письма, черновики, контакты, календарь и вложения доступны агенту через JMAP, CalDAV и WebDAV.
MCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
Email MCP: почта Яндекса, Mail.ru и других провайдеров
Email MCP Server
HTTP/SSE-обертка над IMAP MCP-сервером для удаленного доступа к почте из Claude Web: чтение, поиск, отправка и до 15 провайдеров, включая Яндекс и Mail.ru
MCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков
Email SMTP/IMAP MCP — почта в нескольких аккаунтах
Email SMTP/IMAP MCP
MCP почта на шесть инструментов: один локальный сервер ищет, читает, отправляет, пересылает и раскладывает письма в любом числе аккаунтов IMAP и SMTP
MCP-сервер чтения почты Mail.ru
Mail.ru MCP
Небольшой read-only MCP-сервер для почты Mail.ru: список писем, чтение, поиск и папки без возможности отправки или удаления
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| jmap-mcp (эта карточка) | нет | API-ключ | 179 | |
| email-mcp — MCP-сервер для почты по IMAP и SMTP | нет | ключ необязателен | 145 | почтовый MCP на 52 инструмента с IMAP и SMTP и несколькими ящиками, этот говорит только по JMAP |
| Email SMTP/IMAP MCP — почта в нескольких аккаунтах | нет | API-ключ | 25 | почта по IMAP и SMTP для серверов без JMAP, этот сервер работает только по протоколу JMAP |
Коротко о README
Репозиторий описан как монорепозиторий Deno с клиентом JMAP и MCP-сервером. Далее идут возможности по группам, установка плагином и вручную, таблица переменных окружения и параметры каждого инструмента, а также пример использования клиента в обычном приложении.