Mailtrap Email Sending

by railsware

Integrations

  • Provides a tool for sending transactional emails via Mailtrap, supporting features like recipients (to, cc, bcc), HTML/text content, subject lines, categories, and sender customization.

MCP Mailtrap Server

An MCP server that provides a tool for sending transactional emails via Mailtrap

Setup

Claude Desktop or Cursor

Add the following configuration:

{ "mcpServers": { "mailtrap": { "command": "npx", "args": ["-y", "mcp-mailtrap"], "env": { "MAILTRAP_API_TOKEN": "your_mailtrap_api_token", "DEFAULT_FROM_EMAIL": "your_sender@example.com" } } } }

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

{ "mcpServers": { "mailtrap": { "command": "/Users/<username>/.asdf/shims/npx", "args": ["-y", "mcp-mailtrap"], "env": { "PATH": "/Users/<username>/.asdf/shims:/usr/bin:/bin", "ASDF_DIR": "/opt/homebrew/opt/asdf/libexec", "ASDF_DATA_DIR": "/Users/<username>/.asdf", "ASDF_NODEJS_VERSION": "20.6.1", "MAILTRAP_API_TOKEN": "your_mailtrap_api_token", "DEFAULT_FROM_EMAIL": "your_sender@example.com" } } } }
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

One-click installation (VS Code / VS Code Insiders)

Manually changing config

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

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

{ "mcp": { "servers": { "mailtrap": { "command": "npx", "args": ["-y", "mcp-mailtrap"], "env": { "MAILTRAP_API_TOKEN": "your_mailtrap_api_token", "DEFAULT_FROM_EMAIL": "your_sender@example.com" } } } } }

Tip

Don't forget to restart your MCP server after changing the "env" section.

Usage

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

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, require 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 (optional): Email category for tracking

Development

  1. Clone the repository:
git clone https://github.com/railsware/mailtrap-mcp.git cd mailtrap-mcp
  1. Install dependencies:
npm install

Configuration with Claude Desktop or Cursor

Tip

See the location of the config file in the Setup section.

Add the following configuration:

{ "mcpServers": { "mailtrap": { "command": "node", "args": ["/path/to/mailtrap-mcp/dist/index.js"], "env": { "MAILTRAP_API_TOKEN": "your_mailtrap_api_token", "DEFAULT_FROM_EMAIL": "your_sender@example.com" } } } }

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

(example for Mac)

{ "mcpServers": { "mailtrap": { "command": "/Users/<username>/.asdf/shims/node", "args": ["/path/to/mailtrap-mcp/dist/index.js"], "env": { "PATH": "/Users/<username>/.asdf/shims:/usr/bin:/bin", "ASDF_DIR": "/opt/homebrew/opt/asdf/libexec", "ASDF_DATA_DIR": "/Users/<username>/.asdf", "ASDF_NODEJS_VERSION": "20.6.1", "MAILTRAP_API_TOKEN": "your_mailtrap_api_token", "DEFAULT_FROM_EMAIL": "your_sender@example.com" } } } }

VS Code

Tip

See the location of the config file in the Setup section.

{ "mcp": { "servers": { "mailtrap": { "command": "node", "args": ["/path/to/mailtrap-mcp/dist/index.js"], "env": { "MAILTRAP_API_TOKEN": "your_mailtrap_api_token", "DEFAULT_FROM_EMAIL": "your_sender@example.com" } } } } }

Testing

You can test the server using the MCP Inspector:

npm run dev

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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrates with Mailtrap Email Platform to enable sending transactional emails via API.

  1. Setup
    1. Claude Desktop or Cursor
    2. VS Code
  2. Usage
    1. Available Tools
      1. send-email
    2. Development
      1. Configuration with Claude Desktop or Cursor
      2. VS Code
    3. Testing
      1. Contributing
        1. License
          1. Code of Conduct

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              Integrates with Gmail to enable sending, reading, drafting, and managing emails via the Model Context Protocol (MCP), allowing users to interact with email tasks through automated client prompts.
              Last updated -
              Python
              GPL 3.0
            • -
              security
              F
              license
              -
              quality
              Allows sending emails through the Resend service using a standardized Model Context Protocol (MCP) interface, with TypeScript support.
              Last updated -
              13
              5
              TypeScript
            • -
              security
              A
              license
              -
              quality
              Provides IMAP and SMTP capabilities, enabling developers to manage email services with seamless integration and automated workflows.
              Last updated -
              27
              Python
              BSD 3-Clause
              • Apple
              • Linux
            • A
              security
              F
              license
              A
              quality
              A simple MCP server that enables users to send emails using Resend's API, integrating with tools like Cursor and Claude Desktop for seamless email composition and delivery.
              Last updated -
              1
              6
              321
              TypeScript
              • Apple

            View all related MCP servers

            ID: 5k4ufjv9zm