English Français العربية

Groundmail

Official registry Productivity

Send transactional email and manage domains, templates, webhooks and suppressions with Groundmail.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http groundmail 'https://mcp.groundmail.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "groundmail": {
            "type": "http",
            "url": "https://mcp.groundmail.dev/mcp"
        }
    }
}
NPM package groundmail-mcp
Claude Code 
claude mcp add groundmail -e 'GROUNDMAIL_API_KEY=<your groundmail_api_key>' -e 'GROUNDMAIL_API_URL=<GROUNDMAIL_API_URL>' -- npx -y groundmail-mcp@0.16.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "groundmail": {
            "command": "npx",
            "args": [
                "-y",
                "groundmail-mcp@0.16.1"
            ],
            "env": {
                "GROUNDMAIL_API_KEY": "<your groundmail_api_key>",
                "GROUNDMAIL_API_URL": "<GROUNDMAIL_API_URL>"
            }
        }
    }
}

Environment variables

  • GROUNDMAIL_API_KEY required secret Groundmail API key (starts with gm_). Create one at https://app.groundmail.dev/api-keys
  • GROUNDMAIL_API_URL Optional API base URL override (default https://api.groundmail.dev)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Groundmail MCP server
  2. Quick start
  3. What you can ask for
  4. Transports
  5. Why Groundmail
  6. All Groundmail libraries

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
ClientHow to connect
Claude Codeclaude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp, then run /mcp, pick groundmail and choose Authenticate
CursorAdd { "mcpServers": { "groundmail": { "url": "https://mcp.groundmail.dev/mcp" } } } to .cursor/mcp.json; Cursor shows "Needs login"
Claude.aiSettings → Connectors → Add custom connector → paste the URL
ChatGPTSettings → Apps & Connectors → Create (developer mode) → paste the URL, authentication OAuth

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, list, look up), domains (add, apply DNS through Cloudflare, Vercel or GoDaddy, verify), templates, webhooks, suppressions, address validation, deliverability, DMARC monitoring, email testing (a test address per run, then wait for the email and read its code and links), imports from other providers and tenants (one per customer you send for: create, update, pause, resume, stats; tenant on sends, domains and suppressions). Each tool carries read-only and destructive annotations and an output schema. Full list: docs.groundmail.dev/ai/mcp.

Transports

ModeCommand / URLAuth
HTTP (hosted)https://mcp.groundmail.dev/mcpOAuth (recommended) or Authorization: Bearer gm_…
stdionpx -y groundmail-mcpGROUNDMAIL_API_KEY=gm_…
HTTP (local)npx -y groundmail-mcp --http --port 3000Authorization: Bearer gm_… on each request

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

Cursor with an API key (stdio)

.cursor/mcp.json:

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

Cursor with an API key (local or hosted HTTP)

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

For the hosted server with a key instead of OAuth, use "url": "https://mcp.groundmail.dev/mcp" with the same header.

Claude Code with an API key

# 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. Free covers 3,000 emails a month. After that it's pay as you go: $0.70 per 1,000, less as you grow. Pricing
  • 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

UsePackage
Node.js / TypeScriptgroundmail on npm
Python (Django), Go, Ruby (Rails Action Mailer)Groundmail/groundmail-sdks
PHPGroundmail/groundmail-php
LaravelGroundmail/groundmail-laravel
Symfony MailerGroundmail/groundmail-symfony-mailer
NodemailerGroundmail/groundmail-nodemailer
NestJSGroundmail/nestjs-groundmail
StrapiGroundmail/strapi-provider-email-groundmail
MedusaGroundmail/medusa-notification-groundmail
AdonisJSGroundmail/adonisjs-groundmail
Phoenix (Swoosh)Groundmail/swoosh_groundmail
CLIgroundmail-cli on npm
MCP server (Claude, ChatGPT, Cursor)Groundmail/groundmail-mcp
Agent skills and Claude Code pluginGroundmail/groundmail-skills
Email templates (React Email, MJML, HTML)Groundmail/email-templates

Website · Docs · Pricing · Sign up free

Frequently asked questions

What is Groundmail?

Send transactional email and manage domains, templates, webhooks and suppressions with Groundmail.

How do I install Groundmail?

It runs as a remote server. In Claude Code: claude mcp add --transport http groundmail 'https://mcp.groundmail.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Groundmail need an API key?

Yes. It expects GROUNDMAIL_API_KEY, which you set in its configuration.

Is Groundmail open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Groundmail?

It is published by Groundmail. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.