Groundmail
Send and track email, manage domains and templates from any MCP client
The server answered 3 days ago with a sign-in request for OAuth (HTTP 401), so we could not list its tools.
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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.groundmail.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"groundmail": {
"url": "https://mcp.groundmail.dev/mcp"
}
}
}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/mcpEnter 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.
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-keysRequiredGROUNDMAIL_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.