GetMailer MCP Server

MCP (Model Context Protocol) server for GetMailer - Send transactional emails from AI assistants like Claude.

Installation

Setup with Claude Desktop

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Or if installed globally:

Available Tools

send_email

Send a transactional email.

Parameters:

• from (required): Sender email address

• to (required): Array of recipient addresses

• subject (required): Email subject

• html: HTML content

• text: Plain text content

• cc: CC recipients

• bcc: BCC recipients

• replyTo: Reply-to address

• templateId: Template ID (instead of html/text)

• variables: Template variables

Example:

list_emails

List sent emails with status information.

Parameters:

• limit: Number of emails to return (default: 20)

• cursor: Pagination cursor

get_email

Get details of a specific email including delivery events.

Parameters:

• id (required): Email ID

list_templates

List available email templates.

create_template

Create a new email template.

Parameters:

• name (required): Template name

• subject (required): Subject line (can include {{variables}})

• html (required): HTML content (can include {{variables}})

• text: Plain text content

list_domains

List verified sending domains.

add_domain

Add a new sending domain.

Parameters:

• domain (required): Domain name (e.g., example.com)

Returns DNS records that need to be configured.

verify_domain

Check if a domain has been verified.

Parameters:

• id (required): Domain ID

get_analytics

Get email analytics and statistics.

Parameters:

• type: "summary" or "daily"

• days: Number of days for daily stats

list_suppression

List suppressed email addresses.

Parameters:

• limit: Number of entries to return

add_to_suppression

Add email addresses to the suppression list.

Parameters:

• emails (required): Array of email addresses

• reason: MANUAL, BOUNCE, or COMPLAINT

create_batch

Create a batch email job.

Parameters:

• name (required): Batch name

• from (required): Sender address

• recipients (required): Array of {to, variables} objects

• subject: Email subject

• html: HTML content

• text: Plain text content

• templateId: Template ID

• replyTo: Reply-to address

list_batches

List batch email jobs.

get_batch

Get batch job status and progress.

Parameters:

• id (required): Batch ID

Usage Examples

Once configured, you can ask Claude:

• "Send an email to user@example.com from notifications@myapp.com saying their order has shipped"

• "List my recent emails"

• "Check the status of email abc123"

• "Create an email template for password resets"

• "Show me my email analytics for the past week"

• "Add user@spam.com to my suppression list"

Environment Variables

• GETMAILER_API_KEY (required): Your GetMailer API key

• GETMAILER_API_URL: Custom API URL (default: https://getmailer.app)

Get Your API Key

1. Sign up at getmailer.app

2. Go to API Keys

3. Create a new API key

Support

• Documentation: getmailer.app/docs

• Issues: GitHub Issues