MCP Server

Send emails from Claude Desktop, Claude Code, and other AI assistants using the Model Context Protocol.

Quick Install

npm install -g getmailer-mcp

Quick Start (No Account Needed)

The fastest way to get started - sign up directly through Claude:

Add MCP server to Claude (no API key needed yet)

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

Ask Claude to sign you up
“Sign me up for GetMailer with email user@example.com and password MyPassword123”
Add the API key Claude returns to your config and restart Claude

Claude Desktop Setup (Existing Users)

If you already have an API key:

Open Claude config file
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Add GetMailer MCP server

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

Claude Code Setup

For Claude Code CLI, run this command:

claude mcp add -s user --transport stdio getmailer \
  -e "GETMAILER_API_KEY=gm_your_api_key_here" \
  -- npx -y getmailer-mcp

Available Tools

Once configured, Claude can use these tools:

signupCreate account and get API key (no auth required)

send_emailSend transactional emails

list_emailsView sent emails and status

get_emailGet email details with events

list_templatesList email templates

create_templateCreate new templates

list_domainsView verified domains

add_domainAdd sending domains

verify_domainCheck domain status

get_analyticsView email statistics

list_suppressionView suppressed addresses

add_to_suppressionAdd to suppression list

create_batchSend bulk emails

list_batchesView batch jobs

get_batchCheck batch progress

Example Prompts

Try asking Claude things like:

“Send an email to user@example.com from hello@myapp.com saying their order shipped”

“Show me my email analytics for the past week”

“Create a welcome email template with name and company variables”

“List my recent sent emails”

“Check if example.com domain is verified”

Environment Variables

Variable	Required	Description
`GETMAILER_API_KEY`	No*	Your GetMailer API key (optional for signup, required for other tools)
`GETMAILER_API_URL`	No	Custom API URL (default: https://getmailer.co)

Resources

npm: getmailer-mcp GitHub repository Model Context Protocol docs