Notmuch Sendmail

🚀 MCP Notmuch Sendmail

MCP Notmuch Sendmail connects the Claude desktop version with your notmuch mail database, enabling you to search, browse, and manage your emails efficiently.

🚀 Quick Start

MCP Notmuch Sendmail serves as your email assistant. It links the Claude desktop version with your notmuch email database, allowing you to:

• Search and browse your email threads.
• View clean, plain - text conversations.
• Write new emails using Markdown.
• Send and manage emails.

📦 Installation

Install Dependencies

pip install markdown-it-py html2text python-notmuch

Start MCP Sendmail

python3 mcp_sendmail.py

✨ Features

MCP Notmuch Sendmail offers the following features:

• Email Sending: Send emails via smtplib, supporting both HTML and plain - text formats.
• Email Parsing: Use the mail-parser library to parse email content, identifying email headers and bodies.
• Template Rendering: Generate customized email content using the Jinja2 template engine.
• Attachment Management: Support adding attachment files of any type.

💻 Usage Examples

Configure SMTP Information

Fill in your SMTP server information in the config.py file:

_SMTP_SERVER = 'smtp.example.com'
_SMTP_PORT = 587
_SMTP_USERNAME = 'your_email@example.com'
_SMTP_PASSWORD = 'your_password'

Send Emails

# Send a plain - text email
send_plain_text("recipient_email@example.com", "Email Subject", "Email body content")

# Send an HTML - formatted email
send_html_email("recipient_email@example.com", "Email Subject", "<h1>HTML Email</h1><p>This is the body of an HTML - formatted email.</p>", ["attachment1.pdf"])

Basic Usage

def send_plain_text(to, subject, body):
    msg = MIMEText(body)
    msg['Subject'] = subject
    msg['From'] = _SMTP_USERNAME
    msg['To'] = to
    
    with smtplib.SMTP(_SMTP_SERVER, _SMTP_PORT) as server:
        server.starttls()
        server.login(_SMTP_USERNAME, _SMTP_PASSWORD)
        server.sendmail(_SMTP_USERNAME, [to], msg.as_string())

Advanced Usage

def send_html_email(to, subject, html_content, attachments=None):
    msg = MIMEMultipart('alternative')
    msg.attach(MIMEText('', 'plain', 'utf-8'))
    
    templateLoader = jinja2.FileSystemLoader(searchpath="./templates")
    templateEnv = jinja2.Environment(loader=templateLoader)
    template = templateEnv.get_template("email_template.html")
    output_text = template.render()
    
    part = MIMEText(output_text, 'html')
    msg.attach(part)
    
    if attachments:
        for attachment in attachments:
            with open(attachment, 'rb') as file:
                part = MIMEBase('application', 'octet-stream')
                part.set_payload(file.read())
                encoders.encode_base64(part)
                part.add_header('Content-Disposition', f'attachment; filename="{os.path.basename(attachment)}"')
                msg.attach(part)
    
    with smtplib.SMTP(_SMTP_SERVER, _SMTP_PORT) as server:
        server.starttls()
        server.login(_SMTP_USERNAME, _SMTP_PASSWORD)
        server.sendmail(_SMTP_USERNAME, [to], msg.as_string())

🔧 Technical Details

Project Features

• Dependency Management: Manage all third - party libraries via pip to ensure compatibility and maintainability.
• Modular Design: Functional modules are developed and tested independently, facilitating expansion and maintenance.
• Template Support: Implement dynamic generation of email content using the Jinja2 template engine.

Project Structure

mcp_sendmail/
├── sendmail.py         # Core logic for email sending
├── templates/          # Folder for HTML email templates
│   └── email_template.html    # Example HTML email template
└── config.py           # SMTP server configuration information

Contribution and Support

• Issue Reporting: Feel free to submit any issues or improvement suggestions you encounter.
• Feature Expansion: We aim to add more email sending and management features.
• Documentation Improvement: Help improve the project documentation so that more people can use it easily.

With MCP Notmuch Sendmail, turn the Claude desktop version into a powerful email management tool.