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 addressto(required): Array of recipient addressessubject(required): Email subjecthtml: HTML contenttext: Plain text contentcc: CC recipientsbcc: BCC recipientsreplyTo: Reply-to addresstemplateId: 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 namesubject(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 addressesreason: MANUAL, BOUNCE, or COMPLAINT
create_batch
Create a batch email job.
Parameters:
name(required): Batch namefrom(required): Sender addressrecipients(required): Array of{to, variables}objectssubject: Email subjecthtml: HTML contenttext: Plain text contenttemplateId: Template IDreplyTo: 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
signuptool directly from Claude - no web browser needed!
Option 2: Sign up via web
- Sign up at getmailer.app
- Go to API Keys
- Create a new API key
Support
- Documentation: getmailer.app/docs
- Issues: GitHub Issues