Mailtrap Email Sending

MCP Mailtrap Server

An MCP server that provides tools for sending transactional emails and managing email templates via Mailtrap

Prerequisites

Before using this MCP server, you need to:

1. Create a Mailtrap account
2. Verify your domain
3. Get your API token from Mailtrap API settings
4. Get your Account ID from Mailtrap account management

Quick Install

Setup

Claude Desktop or Cursor

Add the following configuration:

If you are using asdf for managing Node.js you must use absolute path to executable (example for Mac)

Claude Desktop config file location

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor config file location

Mac: ~/.cursor/mcp.json

Windows: %USERPROFILE%\.cursor\mcp.json

VS Code

Manually changing config

Run in Command Palette: Preferences: Open User Settings (JSON)

Then, in the settings file, add the following configuration:

Usage

Once configured, you can ask agent to send emails and manage templates, for example:

Email Operations:

• "Send an email to john.doe@example.com with the subject 'Meeting Tomorrow' and a friendly reminder about our upcoming meeting."
• "Email sarah@example.com about the project update, and CC the team at team@example.com"

Template Operations:

• "List all email templates in my Mailtrap account"
• "Create a new email template called 'Welcome Email' with subject 'Welcome to our platform!'"
• "Update the template with ID 12345 to change the subject to 'Updated Welcome Message'"
• "Delete the template with ID 67890"

Available Tools

send-email

Sends a transactional email through Mailtrap.

Parameters:

• to (required): Email address of the recipient
• subject (required): Email subject line
• from (optional): Email address of the sender, if not provided "DEFAULT_FROM_EMAIL" will be used
• text (optional): Email body text, required if "html" is empty
• html (optional): HTML version of the email body, required if "text" is empty
• cc (optional): Array of CC recipient email addresses
• bcc (optional): Array of BCC recipient email addresses
• category (required): Email category for tracking and analytics

create-template

Creates a new email template in your Mailtrap account.

Parameters:

• name (required): Name of the template
• subject (required): Email subject line
• html (or text is required): HTML content of the template
• text (or html is required): Plain text version of the template
• category (optional): Template category (defaults to "General")

list-templates

Lists all email templates in your Mailtrap account.

Parameters:

• No parameters required

update-template

Updates an existing email template.

Parameters:

• template_id (required): ID of the template to update
• name (optional): New name for the template
• subject (optional): New email subject line
• html (optional): New HTML content of the template
• text (optional): New plain text version of the template
• category (optional): New category for the template

delete-template

Deletes an existing email template.

Parameters:

• template_id (required): ID of the template to delete

Development

1. Clone the repository:

2. Install dependencies:

Configuration with Claude Desktop or Cursor

Add the following configuration:

If you are using asdf for managing Node.js you should use absolute path to executable:

(example for Mac)

VS Code

Testing

You can test the server using the MCP Inspector:

Contributing

Bug reports and pull requests are welcome on GitHub. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

License

The package is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Mailtrap project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.