Fastmail MCP Server
Неофициальный MCP-сервер Fastmail: письма, черновики, контакты, календарь и вложения доступны агенту через JMAP, CalDAV и WebDAV.
- 131 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент может отправлять и удалять письма и массово переносить их от вашего имени.
- Токен открывает всю почту, контакты и календарь, а тела писем попадают в контекст модели.
Установка
- Работает в
Ручная установка
git clone https://github.com/MadLlama25/fastmail-mcp && cd fastmail-mcp
npm install && npm run build
FASTMAIL_API_TOKEN="your_token" node dist/index.jsЗапуск из клона. Для Claude Desktop есть пакет DXT: `npx @anthropic-ai/dxt pack` создает `fastmail-mcp.dxt`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент может отправлять и удалять письма и массово переносить их от вашего имени.
- Токен открывает всю почту, контакты и календарь, а тела писем попадают в контекст модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 52 инструмента для ящика Fastmail: список папок, поиск и чтение писем, черновики, ответы с правильными заголовками цепочки, отправка, перенос и метки. Вложения скачивают, прикладывают к письму и сохраняют в облачное хранилище по WebDAV. Отдельные варианты инструментов отдают только метаданные без тела письма. Контакты читаются и правятся через JMAP, календарь работает по CalDAV. Для почты нужен API-токен Fastmail, для календаря и файлов отдельные данные приложения. Проект неофициальный и с Fastmail не связан.
Для кого. Пользователям Fastmail, которые разбирают почту, отвечают на письма и ведут календарь через Claude Desktop, Claude Code или Cursor.
Подходит, если
- Разобрать входящие: найти письма по отправителю, датам и вложениям и разложить по папкам.
- Подготовить ответ в цепочке и сохранить черновик на проверку.
- Скачать вложения из писем и положить их в облачную папку.
- Свести встречи из календаря и создать событие с участниками.
Не подходит, если
- Почта лежит не в Fastmail: сервер работает только с его API.
- Отправку писем нельзя доверять агенту без проверки: `send_email` отправляет сразу.
- Нужен сервер, который ставится без сборки из исходников.
Пример запроса к агенту
Найди письма бухгалтерии за октябрь с вложениями, покажи темы и сохрани черновик ответа на последнее.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
FASTMAIL_API_TOKENобязательная, секрет- API-токен Fastmail из раздела API tokens
FASTMAIL_BASE_URL- Адрес API, по умолчанию `https://api.fastmail.com`
FASTMAIL_DOWNLOAD_DIR- Каталог для скачанных вложений, по умолчанию `~/Downloads/fastmail-mcp/`
FASTMAIL_CALDAV_USERNAME- Логин CalDAV для календарных инструментов
FASTMAIL_CALDAV_PASSWORDсекрет- Пароль приложения для CalDAV
FASTMAIL_WEBDAV_URL- HTTPS-адрес WebDAV для `save_attachment_to_webdav`
FASTMAIL_WEBDAV_USERNAME- Логин WebDAV
FASTMAIL_WEBDAV_PASSWORDсекрет- Пароль приложения WebDAV с областью Files
Ограничения
Сервер собирают из исходников командами `npm install` и `npm run build`, нужен Node.js 20 и новее. Токен API создают в настройках Fastmail, для записи контактов нужна область read-write. Календарные инструменты идут по CalDAV и требуют пароль приложения, а `save_attachment_to_webdav` требует HTTPS-адрес WebDAV. Пути скачивания вложений ограничены каталогом `FASTMAIL_DOWNLOAD_DIR`. Поиск `search_emails` захватывает корзину и спам, поэтому для проверки удаления исключайте их через `excludeMailboxIds` в `advanced_search`. Для Claude Desktop пакет `.dxt` собирают командой `npx @anthropic-ai/dxt pack`.
Как отключить. Удалите запись сервера из конфигурации клиента и отзовите API-токен в настройках Fastmail. Скачанные вложения в каталоге загрузок удаляют вручную.
Частые вопросы
Как получить токен для Fastmail MCP?
В настройках Fastmail найдите раздел Connected apps и API tokens, создайте новый токен и скопируйте его. Для изменения контактов выдайте доступ read-write.
Как подключить календарь?
Задайте `FASTMAIL_CALDAV_USERNAME` и `FASTMAIL_CALDAV_PASSWORD` с паролем приложения. Без них календарные инструменты сообщают, что CalDAV не настроен.
Можно ли читать письма без тела?
Да. `list_emails_metadata`, `search_emails_metadata` и `get_email_metadata` возвращают только заголовки из разрешенного списка.
Что показывает check_function_availability?
Какие функции доступны при текущих настройках, и подсказывает, что донастроить для остальных.
Какие основные инструменты у сервера?
Начните с `check_function_availability`: он показывает доступные функции и подсказки по настройке. Для писем есть `send_email`, `reply_email`, `create_draft` и `advanced_search`, для контактов `list_contacts`, для календаря события через CalDAV.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для почты по протоколу JMAP: поиск, чтение, пометки, перенос и отправка писем в Fastmail и Stalwart из агента
MCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
MCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков
Email SMTP/IMAP MCP — почта в нескольких аккаунтах
Email SMTP/IMAP MCP
MCP почта на шесть инструментов: один локальный сервер ищет, читает, отправляет, пересылает и раскладывает письма в любом числе аккаунтов IMAP и SMTP
Email MCP: почта Яндекса, Mail.ru и других провайдеров
Email MCP Server
HTTP/SSE-обертка над IMAP MCP-сервером для удаленного доступа к почте из Claude Web: чтение, поиск, отправка и до 15 провайдеров, включая Яндекс и Mail.ru
MCP-сервер для доступа агента к почте, календарю, файлам OneDrive и потокам Power Automate через Microsoft Graph
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Fastmail MCP Server (эта карточка) | нет | API-ключ | 131 | |
| email-mcp — MCP-сервер для почты по IMAP и SMTP | нет | ключ необязателен | 147 | работает с несколькими ящиками по IMAP и SMTP; здесь родной API Fastmail с контактами, календарем и файлами |
| mcp-email-server | нет | не нужна | 376 | почта по IMAP и SMTP для любых провайдеров; здесь только Fastmail, зато с CalDAV и WebDAV |
Коротко о README
Почта, календарь и файлы настраиваются раздельно: токен открывает почту и контакты, календарь и WebDAV требуют собственные данные. Проект распространяется исходниками и пакетом DXT для Claude Desktop.