GetMailer MCP Server

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

Quick Start

The fastest way to get started is to sign up directly through MCP:

1. Add the MCP server to Claude Desktop (no API key needed yet):

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

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

2. Ask Claude to sign you up:

"Sign me up for GetMailer with email user@example.com and password MyPassword123"

3. Claude will return your API key. Update your config:

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

4. Restart Claude Desktop and start sending emails!

Installation

npm install -g getmailer-mcp

Setup with Claude Desktop (Existing Users)

If you already have an API key, add this to your Claude Desktop configuration file:

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

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

Or if installed globally:

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

Available Tools

signup

Create a new GetMailer account directly from Claude. Returns an API key and sends a verification email.

Important: You must verify your email before you can send emails. Check your inbox after signing up!

Parameters:

• email (required): Your email address (no disposable emails)
• password (required): Password (min 8 chars, must include uppercase, lowercase, and number)
• name: Your name (optional)

Example:

Sign me up for GetMailer with my email developer@example.com

account_status

Check your account status including email verification, subscription plan, and sending limits.

Parameters: None

Example:

Check my GetMailer account status

Returns:

• Email verification status
• Subscription plan and remaining emails
• Number of verified domains
• Whether you can send emails
• Any required actions (verify email, add domain, etc.)

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:

Send an email from hello@myapp.com to user@example.com with subject "Welcome!" and HTML content "<h1>Hello!</h1>"

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: Your GetMailer API key (optional for signup, required for other tools)
• GETMAILER_API_URL: Custom API URL (default: https://getmailer.app)

Get Your API Key

Option 1: Sign up via MCP (Recommended)

• Use the signup tool directly from Claude - no web browser needed!

Option 2: Sign up via web

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