CamelMailer Server

CI npm License: MIT

Model Context Protocol server for CamelMailer — lets AI assistants like Claude send and inspect transactional email. Works with the CamelMailer cloud and any self-hosted instance.

Setup

You need a server API key from your CamelMailer dashboard.

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "camelmailer": {
      "command": "npx",
      "args": ["-y", "camelmailer-mcp"],
      "env": {
        "CAMELMAILER_API_KEY": "cm_xxxx"
      }
    }
  }
}

Until the packages land on npm, use the GitHub source instead: "args": ["-y", "github:camelmailer/camelmailer-mcp"]

Claude Code

claude mcp add camelmailer -e CAMELMAILER_API_KEY=cm_xxxx -- npx -y camelmailer-mcp

Self-hosted instances

Point the server at your own instance (defaults to https://app.camelmailer.com):

"env": {
  "CAMELMAILER_API_KEY": "cm_xxxx",
  "CAMELMAILER_BASE_URL": "https://mail.example.com"
}

Tools

Tool	Description
send_email	Send an email with html_body / text_body
send_email_with_template	Render a stored template against variables and send
list_emails	List messages (filter by scope, status, tag, query, stream)
get_email	One message incl. SMTP delivery attempts
list_templates	All stored message templates
render_template	Preview a rendered template — no send
get_stats	Message counters (sent, bounced, opens, clicks, …)
list_bounces	Bounced messages
dmarc_summary	DMARC pass rate and top sending sources

Example prompts:

Send a plain-text email from [email protected] to [email protected] thanking her for the purchase.

Why did yesterday's emails to @gmail.com addresses bounce?

What's our DMARC pass rate for acme.com this month?

Errors

API failures come back as tool errors carrying the stable CamelMailer error code (Unauthorized, NotFound, ValidationError, …), so the assistant can react — nothing crashes the server.

Docs

Full API reference: camelmailer.com/docs · SDK: camelmailer-node · CLI: camelmailer-cli

License

MIT