MCP Notmuch Sendmail
Статус: Работает отлично и используется ежедневно, никаких известных ошибок не обнаружено.
Status2: Я только что добавил пакет в PyPI и обновил инструкции по использованию. Пожалуйста, сообщайте о любых проблемах :)
Позвольте Claude стать вашим помощником по электронной почте! MCP Notmuch Sendmail подключает Claude Desktop к вашей базе данных электронной почты notmuch, позволяя ему:
Поиск и просмотр цепочек писем
Просмотр разговоров в чистом текстовом формате
Создавайте новые электронные письма с использованием Markdown
Отвечайте на темы с помощью интеллектуальной дедупликации цитируемого контента
Создавайте красивые электронные письма с использованием стилей в стиле LaTeX
Синхронизируйте свою базу данных электронной почты, запустив настроенный скрипт
Использует html2text для рендеринга HTML-писем и markdown-it для составления насыщенных HTML-писем со встроенными изображениями.
Установка
Убедитесь, что у вас установлено УФ-излучение:
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | shRelated MCP server: iMessage MCP Server
Использование с Claude Desktop
Добавьте в ваш claude_desktop_config.json :
{
"mcpServers": {
"email": {
"command": "uvx",
"args": ["--from", "mcp-notmuch-sendmail==2025.04.09.174710", "--python", "3.10",
"--refresh", "mcp-notmuch-sendmail"]
"env": {
"NOTMUCH_DATABASE_PATH": "/path/to/your/notmuch/db",
"NOTMUCH_REPLY_SEPARATORS": "Pipe|Separated|Phrases",
"SENDMAIL_FROM_EMAIL": "your.email@example.com",
"SENDMAIL_EMAIL_SIGNATURE_HTML": "<p>Optional HTML signature</p>",
"NOTMUCH_SYNC_SCRIPT": "/path/to/your/sync/script.sh",
"LOG_FILE_PATH": "/path/to/log/file.log",
"DRAFT_DIR": "/path/for/email/drafts"
}
}
}
}Переменные среды
NOTMUCH_DATABASE_PATH: Путь к вашей базе данных notmuch (обязательно)NOTMUCH_REPLY_SEPARATORS: список текстовых маркеров, разделенных вертикальной чертой, — сохраняет содержимое письма до первой строки, начинающейся с любого из этих маркеров, удаляя цитируемые ответы (обязательно)SENDMAIL_FROM_EMAIL: Ваш адрес электронной почты для поля «От:» (обязательно)SENDMAIL_EMAIL_SIGNATURE_HTML: HTML-подпись для добавления к электронным письмам (необязательно)NOTMUCH_SYNC_SCRIPT: Путь к скрипту для синхронизации электронной почты (необязательно)LOG_FILE_PATH: Путь к файлу журнала (необязательно)DRAFT_DIR: Каталог для хранения черновиков электронной почты (необязательно, по умолчанию /tmp/mcp-notmuch-sendmail)
API
Инструменты
найти_email_thread
Найти темы электронной почты в базе данных notmuch
Ввод:
notmuch_search_query(строка)Возвращает список потоков, разделенных табуляцией, в формате: GXP3
просмотр_электронной_почты_тред
Просмотреть все сообщения для ветки электронной почты
Ввод:
thread_id(строка)Возвращает разговор в текстовом формате с преобразованием HTML->текст GXP4
написать_новое_письмо
Составьте новый черновик письма из markdown. Подпись будет добавлена автоматически, если установлено SENDMAIL_EMAIL_SIGNATURE_HTML.
Входные данные:
subject(строка): Тема письмаbody_as_markdown(string): Текст электронного письма в формате markdownto(список): Адреса электронной почты получателейcc(список, необязательно): получатели копииbcc(список, необязательно): получатели BCC
Создает файлы черновиков и возвращает пути: GXP5
написать_ответ_по_электронной_почте
Напишите ответ на существующую ветку электронной почты. Подпись будет добавлена автоматически, если установлено SENDMAIL_EMAIL_SIGNATURE_HTML.
Входные данные:
thread_id(строка): идентификатор темы, на которую нужно ответитьsubject(строка): Тема письмаbody_as_markdown(string): Текст электронного письма в формате markdownto(список): Адреса электронной почты получателейcc(список, необязательно): получатели копииbcc(список, необязательно): получатели BCC
Создает файлы черновиков и возвращает пути: GXP6
отправить_электронное письмо
Отправляет составленный черновик электронного письма
Ввод не требуется
Возвращает сообщение об успехе/ошибке
синхронизация_электронных писем
Синхронизирует электронную почту, запуская настроенный скрипт
Ввод не требуется
Возвращает выходные данные скрипта, включая stdout и stderr
Доступно только если настроен NOTMUCH_SYNC_SCRIPT
Разделители ответов
Переменная окружения NOTMUCH_REPLY_SEPARATORS управляет обнаружением ответов по электронной почте. При просмотре ветки содержимое каждого письма обрезается на первой строке, которая начинается с любого из настроенных разделителей. Это эффективно удаляет цитируемые ответы, сохраняя при этом новое содержимое.
Вот рекомендуемые шаблоны разделителей для разных языков:
Английский
On|wrote:|From:|Sent:|To:|Subject:|Date:|Cc:|Best regards|Kind Regards|Thanks,|Thank you,|Best,|All the best|regards,|Sent from my|Get Outlook for|CAUTION:|Disclaimer:|Warning:|Confidential:|CONFIDENTIALITY:|---------- Original Message ----------немецкий
Am.*schrieb|Von:|Gesendet|An:|Betreff:|Datum:|Cc:|Organisation:|Mit freundlichen Grüßen|Beste Grüße|Viele Grüße|Hinweis:|Achtung:|Gesendet vonФранцузский
Le.*a écrit|De |Envoyé |À |Objet |Cc |cordialement|salutations|bonne réception|bonne journée|Envoyé depuisГолландский
Op.*schreef:|Van:|Verzonden|Aan:|Onderwerp:|Datum:|Cc:|Met vriendelijke groet|Hartelijke groeten|Bedankt,|Dank u,|Verzonden vanafитальянский
Il.*ha scritto:|Da:|Inviato|A:|Oggetto:|Data:|Cc:|Cordiali saluti|Inviato daПримечание: Используйте | (вертикальную черту) для разделения шаблонов. Это упрощенные шаблоны, полученные из распространенных почтовых клиентов — вам может потребоваться настроить их в соответствии с вашими конкретными потребностями.
Внося вклад
Вклады горячо приветствуются! Будь то отчеты об ошибках, запросы функций, улучшения документации или вклад в код — любой вклад ценен. Не стесняйтесь:
Откройте тему, чтобы сообщить об ошибках или предложить новые функции
Отправляйте запросы на внесение изменений с улучшениями
Расширьте документацию или поделитесь своими примерами использования
Задавайте вопросы и делитесь своим опытом
Цель — сделать управление электронной почтой с помощью Клода еще лучше, и ваши идеи и вклад помогут в достижении этой цели.
Благодарности
Этот проект основан на превосходной работе других:
mail-parser-reply — для комплексных шаблонов маркеров ответов по электронной почте
notmuch - Быстрая индексация почты и поисковая система
html2text — для преобразования HTML-писем в читаемый текст
markdown-it-py - Для создания красивых HTML-писем
latex.css — для форматирования электронной почты в стиле LaTeX
Лицензия
Публичная лицензия Mozilla версии 2.0
Мои другие проекты LLM
MCP Alchemy — подключение Claude Desktop к базам данных для изучения схемы и выполнения SQL.
MCP Redmine — позвольте Claude Desktop управлять вашими проектами и проблемами Redmine.
Diffpilot — многоколоночный просмотрщик различий Git с группировкой файлов и тегами.
Локальные файлы Claude — доступ к локальным файлам в артефактах Claude Desktop.
