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 | sh

Related MCP server: Gmail 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): Текст электронного письма в формате 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 управляет обнаружением ответов по электронной почте. При просмотре ветки содержимое каждого письма обрезается на первой строке, которая начинается с любого из настроенных разделителей. Это эффективно удаляет цитируемые ответы, сохраняя при этом новое содержимое.

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

Английский

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.