MCP Notmuch Sendmail

Статус: Работает отлично и используется ежедневно, никаких известных ошибок не обнаружено.

Status2: Я только что добавил пакет в PyPI и обновил инструкции по использованию. Пожалуйста, сообщайте о любых проблемах :)

Позвольте Claude стать вашим помощником по электронной почте! MCP Notmuch Sendmail подключает Claude Desktop к вашей базе данных электронной почты notmuch, позволяя ему:

• Поиск и просмотр цепочек писем

• Просмотр разговоров в чистом текстовом формате

• Создавайте новые электронные письма с использованием Markdown

• Отвечайте на темы с помощью интеллектуальной дедупликации цитируемого контента

• Создавайте красивые электронные письма с использованием стилей в стиле LaTeX

• Синхронизируйте свою базу данных электронной почты, запустив настроенный скрипт

Использует html2text для рендеринга HTML-писем и markdown-it для составления насыщенных HTML-писем со встроенными изображениями.

Установка

Убедитесь, что у вас установлено УФ-излучение:

Related MCP server: iMessage MCP Server

Использование с Claude Desktop

Добавьте в ваш claude_desktop_config.json :

Переменные среды

• 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): Текст электронного письма в формате markdown

    • to (список): Адреса электронной почты получателей

    • cc (список, необязательно): получатели копии

    • bcc (список, необязательно): получатели BCC

  • Создает файлы черновиков и возвращает пути: GXP5

• написать_ответ_по_электронной_почте

  • Напишите ответ на существующую ветку электронной почты. Подпись будет добавлена автоматически, если установлено SENDMAIL_EMAIL_SIGNATURE_HTML.

  • Входные данные:

    • thread_id (строка): идентификатор темы, на которую нужно ответить

    • subject (строка): Тема письма

    • body_as_markdown (string): Текст электронного письма в формате markdown

    • to (список): Адреса электронной почты получателей

    • cc (список, необязательно): получатели копии

    • bcc (список, необязательно): получатели BCC

  • Создает файлы черновиков и возвращает пути: GXP6

• отправить_электронное письмо

  • Отправляет составленный черновик электронного письма

  • Ввод не требуется

  • Возвращает сообщение об успехе/ошибке

• синхронизация_электронных писем

  • Синхронизирует электронную почту, запуская настроенный скрипт

  • Ввод не требуется

  • Возвращает выходные данные скрипта, включая stdout и stderr

  • Доступно только если настроен NOTMUCH_SYNC_SCRIPT

Разделители ответов

Переменная окружения NOTMUCH_REPLY_SEPARATORS управляет обнаружением ответов по электронной почте. При просмотре ветки содержимое каждого письма обрезается на первой строке, которая начинается с любого из настроенных разделителей. Это эффективно удаляет цитируемые ответы, сохраняя при этом новое содержимое.

Вот рекомендуемые шаблоны разделителей для разных языков:

Английский

немецкий

Французский

Голландский

итальянский

Примечание: Используйте | (вертикальную черту) для разделения шаблонов. Это упрощенные шаблоны, полученные из распространенных почтовых клиентов — вам может потребоваться настроить их в соответствии с вашими конкретными потребностями.

Внося вклад

Вклады горячо приветствуются! Будь то отчеты об ошибках, запросы функций, улучшения документации или вклад в код — любой вклад ценен. Не стесняйтесь:

• Откройте тему, чтобы сообщить об ошибках или предложить новые функции

• Отправляйте запросы на внесение изменений с улучшениями

• Расширьте документацию или поделитесь своими примерами использования

• Задавайте вопросы и делитесь своим опытом

Цель — сделать управление электронной почтой с помощью Клода еще лучше, и ваши идеи и вклад помогут в достижении этой цели.

Благодарности

Этот проект основан на превосходной работе других:

• 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.