Getmailer MCP

🚀 GetMailer MCP Server

GetMailer MCP Server is an MCP (Model Context Protocol) server designed for GetMailer. It enables AI assistants like Claude to send transactional emails, offering a seamless email - sending experience.

🚀 Quick Start

The quickest way to start using GetMailer MCP Server is to sign up directly through MCP:

Step 1: Add the MCP server to Claude Desktop

(No API key is required at this stage)

• macOS: Edit the file ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: Edit the file %APPDATA%\Claude\claude_desktop_config.json

Insert the following configuration:

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

Step 2: Request Claude to sign you up

Tell Claude:

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

Step 3: Update your configuration with the API key

Claude will return your API key. Update the configuration file as follows:

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

Step 4: Restart Claude Desktop

After restarting, you can start sending emails!

📦 Installation

Run the following command to install the package globally:

npm install -g getmailer-mcp

Setup with Claude Desktop (Existing Users)

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

For macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json

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

For Windows

Edit %APPDATA%\Claude\claude_desktop_config.json

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

If installed globally

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

✨ Features

Available Tools

signup

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

⚠️ Important Note

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

Parameters:

• email (required): Your email address (disposable emails are not allowed)
• password (required): Password (minimum 8 characters, must include uppercase, lowercase, and a 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 the configuration is complete, you can ask Claude the following:

• "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"

🔧 Technical Details

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 is needed!

Option 2: Sign up via web

1. Sign up at getmailer.app
2. Go to API Keys
3. Create a new API key

📚 Documentation

• Documentation: getmailer.app/docs
• Issues: GitHub Issues