MCP Notmuch Sendmail

MCP Notmuch Sendmail

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

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

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

• Поиск и просмотр цепочек писем
• Просмотр разговоров в чистом текстовом формате
• Создавайте новые электронные письма с использованием Markdown
• Отвечайте на темы с помощью интеллектуальной дедупликации цитируемого контента
• Создавайте красивые электронные письма с использованием стилей в стиле LaTeX
• Синхронизируйте свою базу данных электронной почты, запустив настроенный скрипт

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

Установка

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

Использование с 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.