Skip to content
MCP serverOfficial: Published to the official MCP Registry by the GitHub account or domain it is named after, which owns its code or website.

Groundmail

Send and track email, manage domains and templates from any MCP client

Answers · sign-in required (OAuth)

The server answered 3 days ago with a sign-in request for OAuth (HTTP 401), so we could not list its tools.

Install

Groundmail is an MCP server for communication. It can run locally on your machine or as a hosted remote server.

Platforms
API, CLI
Runs
Locally or Remotely
Access
Needs sign-in (OAuth)
Version
0.31.4
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.groundmail.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "groundmail": {
      "url": "https://mcp.groundmail.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "groundmail": {
      "type": "http",
      "url": "https://mcp.groundmail.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "groundmail": {
      "serverUrl": "https://mcp.groundmail.dev/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://mcp.groundmail.dev/mcp

Enter a Name (for example "Groundmail"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "groundmail": {
      "type": "http",
      "url": "https://mcp.groundmail.dev/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GROUNDMAIL_API_KEYGroundmail API key (starts with gm_). Create one at https://app.groundmail.dev/api-keysRequired
  • GROUNDMAIL_API_URLOptional API base URL override (default https://api.groundmail.dev)

About Groundmail

Groundmail's server reaches the whole sending side of an email account, not just the send call. An agent can add a domain, have the DNS records applied through Cloudflare, Vercel or GoDaddy, then verify it before the first message goes out.

Two ways to connect are offered. The hosted endpoint at mcp.groundmail.dev signs you in through the browser with OAuth, and you choose Full, Send only or Read only access. The npm package groundmail-mcp runs locally over stdio or local HTTP with a gm_ API key. Tools that need a scope you did not grant return an insufficient_scope error that names the scope.

Beyond sending, the tools cover delivery checks, webhooks, suppressions, address validation, deliverability and DMARC monitoring, plus tenants for people who send on behalf of several customers. Each tool carries read-only or destructive annotations so clients can ask before risky calls.

What it does

Hosted OAuth sign-in
Connect to mcp.groundmail.dev with a browser sign-in and pick Full, Send only or Read only access.
Local stdio package
Run groundmail-mcp with npx and a GROUNDMAIL_API_KEY, or start it as a local HTTP server.
Domain setup
Add a sending domain, apply DNS records through Cloudflare, Vercel or GoDaddy and verify it.
Email testing
Create a test address per run, wait for the message and read its code and links.
Deliverability and DMARC
Check delivery, bounces, deliverability over a time range and DMARC monitoring.
Tenants
Keep sends, domains and suppressions separate for each customer you send for.
Tool annotations
Every tool is marked read-only or destructive and has an output schema.

Good for

  • Send a password reset or transactional email from an agent
  • Check whether the last batch of emails was delivered and list bounces
  • Set up and verify a new sending domain
  • Test an app's signup email by reading the code it sends
  • Run per-customer sending for a multi-tenant product

Pricing

Pricing unknown

Free account available; paid prices not published here

Prices change. Check docs.groundmail.dev before you buy.

Groundmail FAQ

How does authentication work?

The hosted server uses OAuth and shows an approval page where you choose the access level. The local package and API-key setups use a key that starts with gm_.

Can I give an agent send-only access?

Yes. The approval page offers Full, Send only, Read only or a custom set of scopes, and you can revoke a connection under Settings, CLIs and agents.

Which clients are covered in the docs?

Claude, ChatGPT, Cursor, Claude Code, Codex, Windsurf, GitHub Copilot in VS Code, Zed, Warp, Antigravity and Replit Agent.

Does Groundmail run locally?

Yes. npx -y groundmail-mcp runs over stdio, and adding --http starts a local HTTP endpoint that expects a Bearer key.

How do I add Groundmail to Claude Code?

Run this command in your terminal: claude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp

What are the best alternatives to Groundmail?

The closest alternatives to Groundmail are QMailing, Lettio MCP, Inbox Check — Email Deliverability Test, MepMail and Shipmail.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Status: checked automatically by AIPoweredBot on 19 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers