GetMailer

This MCP server lets you manage GetMailer transactional emails from AI assistants. It exposes a set of endpoints for sending emails, templates, domains, analytics, suppression lists, and batch jobs, enabling you to automate email workflows directly from MCP-enabled clients.

How to use

You connect an MCP client to this server by running the local MCP adapter and providing your GetMailer API key. Once connected, you can perform common email tasks such as sending emails, listing recent deliveries, managing templates and domains, and querying analytics. Use the available tools to trigger transactional emails, check delivery events, and automate bulk or template-driven sending from your assistant workflows.

How to install

Prerequisites: You need Node.js and npm installed on your machine.

Install the MCP server globally so you can run it from any terminal.

npm install -g getmailer-mcp

Configuration and startup

To configure the MCP server with Claude Desktop, add the following to your Claude Desktop configuration for macOS or Windows.

{
  "mcpServers": {
    "getmailer": {
      "command": "npx",
      "args": ["getmailer-mcp"],
      "env": {
        "GETMAILER_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

Alternative local startup

If you prefer to run the MCP server directly after installing it globally, configure Claude Desktop with this setup.

{
  "mcpServers": {
    "getmailer": {
      "command": "getmailer-mcp",
      "env": {
        "GETMAILER_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

Available tools

send_email

Send a transactional email with required from, to, and subject fields and optional html or text content, CC/BCC, replyTo, and template support.

list_emails

List sent emails with status information and support for pagination.

get_email

Retrieve details for a specific email, including delivery events.

list_templates

List available email templates.

create_template

Create a new email template with subject and HTML content and optional text fallback.

list_domains

List verified sending domains.

add_domain

Add a new sending domain and return DNS records to configure.

verify_domain

Check whether a domain has been verified.

get_analytics

Get email analytics and statistics, either a summary or daily stats.

list_suppression

List suppressed email addresses such as manual blocks, bounces, or complaints.

add_to_suppression

Add addresses to the suppression list with an optional reason.

create_batch

Create a batch email job for large-scale sending.

list_batches

List all batch email jobs.

get_batch

Get status and progress for a batch job.