Groundmail MCP server

Send transactional email and manage domains, templates, webhooks and suppressions
from Claude, Claude Code, ChatGPT, Cursor and any other MCP client.

Docs · Get a free account · groundmail.dev

Quick start

The fastest way is the hosted server. Add the URL, sign in through your browser, and you're done. No API key to copy.

https://mcp.groundmail.dev/mcp

When you connect, you choose the access: Full, Send only or Read only. Revoke it any time in Groundmail under Settings → CLIs & agents.

What you can ask for

"Send a password reset email to ada@example.com from noreply@mail.acme.com."

"Did my last 10 emails get delivered? Show any bounces."

"Add mail.acme.com as a sending domain and apply the DNS records on Cloudflare."

"How is my deliverability over the last 7 days?"

Tools cover emails (send, schedule, cancel, look up), domains (add, apply DNS, verify), templates, webhooks, suppressions and deliverability. Each tool carries read-only and destructive annotations and an output schema. Full list: docs.groundmail.dev/ai/mcp.

Transports

Optional: GROUNDMAIL_API_URL (for example http://localhost:3003/api against a local API).

Local HTTP endpoint: http://127.0.0.1:3000/mcp · health: GET /health Hosted health: GET https://mcp.groundmail.dev/health

{
  "mcpServers": {
    "groundmail": {
      "command": "npx",
      "args": ["-y", "groundmail-mcp"],
      "env": {
        "GROUNDMAIL_API_KEY": "gm_your_key_here"
      }
    }
  }
}

npx -y groundmail-mcp --http --port 3000

{
  "mcpServers": {
    "groundmail": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer gm_your_key_here"
      }
    }
  }
}

# Hosted, API key
claude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp \
  --header "Authorization: Bearer $GROUNDMAIL_API_KEY"

# Local stdio
claude mcp add groundmail --env GROUNDMAIL_API_KEY=gm_your_key_here -- npx -y groundmail-mcp

Want your coding agent to know Groundmail too? Install the agent skills: npx skills add Groundmail/groundmail-skills -y.

Why Groundmail

• Our own mail servers and IP space. Your password resets and receipts don't share a pool with bulk marketing senders.
• Transactional email only. No newsletters or cold outreach on the platform, which keeps the sending reputation clean.
• Start free. 3,000 emails a month on the Free plan; Pro is 50,000 emails for $20/month. Dedicated IPs on Scale.
• Built for code and for agents. REST API, SMTP, SDKs for Node, Python, Go, PHP and Ruby, a CLI, and an MCP server for Claude, ChatGPT and Cursor.

All Groundmail libraries

Website · Docs · Pricing · Sign up free