MCP server for Groundmail transactional email: send email, check delivery and set up sending domains from Claude, ChatGPT, Cursor and any MCP client. Hosted with OAuth at mcp.groundmail.dev.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add groundmail --env GROUNDMAIL_API_KEY='<GROUNDMAIL_API_KEY>' -- npx -y groundmail-mcp~/.codex/config.toml
[mcp_servers.groundmail]
command = "npx"
args = ["-y", "groundmail-mcp"]
env = { GROUNDMAIL_API_KEY = "<GROUNDMAIL_API_KEY>" }
# codex mcp add groundmail --env GROUNDMAIL_API_KEY='<GROUNDMAIL_API_KEY>' -- npx -y groundmail-mcp~/.cursor/mcp.json
{
"mcpServers": {
"groundmail": {
"command": "npx",
"args": [
"-y",
"groundmail-mcp"
],
"env": {
"GROUNDMAIL_API_KEY": "<GROUNDMAIL_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"groundmail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"groundmail-mcp"
],
"env": {
"GROUNDMAIL_API_KEY": "<GROUNDMAIL_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"groundmail": {
"command": "npx",
"args": [
"-y",
"groundmail-mcp"
],
"env": {
"GROUNDMAIL_API_KEY": "<GROUNDMAIL_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"groundmail": {
"command": "npx",
"args": [
"-y",
"groundmail-mcp"
],
"env": {
"GROUNDMAIL_API_KEY": "<GROUNDMAIL_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"groundmail": {
"command": "npx",
"args": [
"-y",
"groundmail-mcp"
],
"env": {
"GROUNDMAIL_API_KEY": "<GROUNDMAIL_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp~/.codex/config.toml
[mcp_servers.groundmail]
url = "https://mcp.groundmail.dev/mcp"
# codex mcp add groundmail --url https://mcp.groundmail.dev/mcp~/.cursor/mcp.json
{
"mcpServers": {
"groundmail": {
"url": "https://mcp.groundmail.dev/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"groundmail": {
"type": "http",
"url": "https://mcp.groundmail.dev/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"groundmail": {
"httpUrl": "https://mcp.groundmail.dev/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"groundmail": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.groundmail.dev/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"groundmail": {
"url": "https://mcp.groundmail.dev/mcp"
}
}
}Environment variables
GROUNDMAIL_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.