Log inSubmit server
Groundmail logo

Groundmail

Send transactional email and manage Groundmail domains, templates, webhooks, suppressions, and deliverability through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Groundmail

Pick your client, then add it in one click or paste the config.

SSE (Remote)
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "groundmail": {
      "command": "npx",
      "args": [
        "-y",
        "groundmail-mcp"
      ],
      "env": {
        "GROUNDMAIL_API_KEY": "YOUR_VALUE_HERE",
        "GROUNDMAIL_API_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Hosted endpointLive · 1d agoLive Remote EndpointOur automated health check connected to this remote MCP endpoint successfully.Last checked 10/21/2026, 7:00:31 PM

Clients with native remote MCP support can connect directly to this URL.

Remote endpoint
https://mcp.groundmail.dev/mcp

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Groundmail MCP server connects AI clients to Groundmail for transactional email operations and account management. It supports hosted HTTP with OAuth, API-key authentication, or local stdio and HTTP transports. Available operations include sending and reviewing email, configuring domains, managing templates and webhooks, checking suppressions, and monitoring deliverability. Reach for it when an agent needs controlled access to email infrastructure from a Communication workflow.

Use cases

  • Send password-reset and receipt emails
  • Review recent deliveries and bounces
  • Verify sending domains and apply DNS records
  • Monitor deliverability and DMARC status
  • Manage tenant email accounts and suppressions

Key features

  • Transactional email sending and lookup
  • Domain verification and DNS configuration
  • Template, webhook, and suppression management
  • Deliverability and DMARC monitoring
  • Tenant lifecycle and statistics
  • Hosted OAuth, stdio, and local HTTP transports

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 21h ago via OSV.dev · groundmail-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads3kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.

How Groundmail works

What Groundmail does

The Groundmail MCP server exposes Groundmail’s transactional email features to MCP-compatible clients. An agent can send messages, inspect recent email activity, and look up delivery results such as bounces. It can also work with sending domains, templates, webhooks, suppressions, address validation, deliverability reporting, and DMARC monitoring.

Domain operations include adding and verifying domains. DNS records can be applied through Cloudflare, Vercel, or GoDaddy. The server also supports importing data from other providers and managing customer tenants. A tenant represents a customer an account sends mail for and can be created, updated, paused, resumed, and reviewed for statistics. Sends, domains, and suppressions can be associated with a tenant.

The Groundmail MCP server fits the Communication category for workflows that need an AI client to operate transactional email systems rather than compose or send ordinary personal mail.

How it works

Groundmail provides a hosted MCP endpoint at https://mcp.groundmail.dev/mcp. Clients connect over HTTP and authenticate through a browser-based OAuth flow, or send an API key as a bearer token. Access can be scoped as Full, Send only, or Read only, and access can later be revoked from Groundmail settings.

The package also supports local execution. A stdio process runs with npx -y groundmail-mcp, while local HTTP mode runs with npx -y groundmail-mcp --http --port 3000. Local HTTP clients connect to http://127.0.0.1:3000/mcp and provide the bearer token on requests. The local service exposes GET /health; the hosted service has a corresponding health endpoint.

Tools include read-only and destructive annotations plus output schemas, allowing clients to distinguish operation types and interpret structured results.

Setup and configuration

For the hosted option, add the MCP URL to the client and complete authentication. Claude Code, Cursor, Claude.ai, and ChatGPT each have documented connection paths in the project README. Cursor can also run the package through stdio or connect to a local HTTP process.

Stdio and local HTTP use GROUNDMAIL_API_KEY. Set GROUNDMAIL_API_URL only when the MCP process should target a different API endpoint, such as a local API. Hosted HTTP can use OAuth or a bearer token instead of a locally configured key.

Tools and capabilities

The Groundmail MCP server covers:

  • Sending, listing, and looking up emails
  • Adding, verifying, and configuring sending domains
  • Applying DNS records through Cloudflare, Vercel, or GoDaddy
  • Managing templates, webhooks, and suppressions
  • Validating addresses and reviewing deliverability
  • Monitoring DMARC status
  • Importing from other providers
  • Creating and managing tenants, including tenant statistics

Limitations and notes

The platform is described as transactional email only, not newsletters or cold outreach. OAuth is available for the hosted endpoint, while local modes require API-key authentication. The exact complete tool list is maintained in Groundmail’s MCP documentation.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Groundmail

Groundmail is an MCP server that connects AI clients to Groundmail’s transactional email platform. Its main tools send, list, and inspect emails; manage domains, templates, webhooks, and suppressions; validate addresses; monitor deliverability and DMARC; and manage customer tenants. It supports hosted HTTP, stdio, and local HTTP connections.

Install it by running `npx -y groundmail-mcp` for a stdio connection, or add `https://mcp.groundmail.dev/mcp` as a hosted MCP endpoint. Local HTTP mode uses `npx -y groundmail-mcp --http --port 3000`. Stdio and local HTTP require `GROUNDMAIL_API_KEY`.

Yes, Groundmail works with Cursor. Add the hosted MCP URL to `.cursor/mcp.json`, or configure Cursor to launch `npx -y groundmail-mcp` with `GROUNDMAIL_API_KEY`. Cursor can also connect to a local HTTP endpoint with a bearer-token header.

Yes, Groundmail can apply DNS records through Cloudflare, Vercel, or GoDaddy. The server also supports adding and verifying sending domains, so an agent can manage these domain steps through the available MCP tools.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGroundmail AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/groundmail?style=directory)](https://allmcps.com/mcp/groundmail)
HTML Embed
<a href="https://allmcps.com/mcp/groundmail"><img src="https://allmcps.com/api/badge/groundmail?style=directory" alt="Groundmail on AllMCPs" /></a>