Mail

🚀 Sending Emails MCP Usage Guide

Configuration Guide

Windows System Configuration

1. Open the Cursor editor and find or create the mcp.json file at the path: C:\Users\Your_Username\.cursor\mcp.json.
2. Add or modify the following content to the file:

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "C:\\Users\\Your_Username\\mcp-mail\\bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ Important Note

• Replace Your_Username with your actual Windows username.
• Ensure that the path correctly points to the actual location of the project files.
• Do not delete or move the project folder.

macOS System Configuration

1. Open the terminal and run the command: cd ~ && ls -a to view hidden directories.
2. Create or edit the mcp.json file in the ~/.cursor/ directory.
3. Add the following content to the file:

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "/Users/Your_Username/mcp-mail/bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ Important Note

• Replace Your_Username with your actual macOS username.
• Ensure that the path correctly points to the actual location of the project files.
• Do not delete or move the project folder.

Linux System Configuration

1. Open the terminal and run the command: cd ~ && ls -a to view hidden directories.
2. Create or edit the mcp.json file in the ~/.cursor/ directory.
3. Add the following content to the file:

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "/home/Your_Username/mcp-mail/bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ Important Note

• Replace Your_Username with your actual Linux username.
• Ensure that the path correctly points to the actual location of the project files.
• Do not delete or move the project folder.

Starting the Service

1. Open the terminal and run the following command to start the MCP service:

   npm start mcp
   

2. Check the console output to confirm that the service has started successfully.

💻 Usage Examples

Sending Emails

const mcp = require('mcp');

// Sending a regular email
mcp.sendEmail({
    from: 'your.email@example.com',
    to: 'recipient@example.com',
    subject: 'Test Email',
    text: 'This is a test email'
}).then(() => {
    console.log('Email sent successfully');
}).catch(error => {
    console.error('Failed to send:', error);
});

// Sending an email with an attachment
mcp.sendEmail({
    from: 'your.email@example.com',
    to: 'recipient@example.com',
    subject: 'Test Email with Attachment',
    text: 'Please check the attachment',
    attachments: [
        {
            filename: 'test.txt',
            content: 'This is the attachment content'
        }
    ]
}).then(() => {
    console.log('Email sent successfully');
}).catch(error => {
    console.error('Failed to send:', error);
});

📚 Documentation

Email Sending Process

1. Initialize the MCP service: Configure SMTP and IMAP parameters and establish a connection with the email server.
2. Create email content: Include information such as the sender, recipient, subject, and body.
3. Add attachments (optional): Attach files to the email.
4. Send the email: Send the email to the target mailbox via the SMTP protocol.

Technical Implementation

• Use the nodeMailer library to handle SMTP communication.
• Use the mail client library to handle IMAP operations.
• Support attachment handling and multiple email formats.
• Provide error handling and logging functions.

Other Notes

• Dependencies: You need to install nodeMailer and mail client library.
• Environment Variables: Configure SMTP and IMAP information through environment variables.
• License: This project follows the MIT License and can be freely used and modified.

If you have any questions, please contact technical support.