![\"Groundmail\"](\"https://app.groundmail.dev/images/github/readme-logo-dark.png\"){kind=logo}
\n \n \n \n
\n Send transactional email and manage domains, templates, webhooks and suppressions
\n from Claude, Claude Code, ChatGPT, Cursor and any other MCP client.\n
\n ![\"npm\"](\"https://img.shields.io/npm/v/groundmail-mcp?color=a3461f&label=npm\")
![\"MCP](\"https://img.shields.io/badge/MCP%20registry-io.github.Groundmail%2Fgroundmail-241c15\"){kind=icon}
![\"License:](\"https://img.shields.io/badge/license-MIT-b48f62\"){kind=icon}
\n Docs ·\n Get a free account ·\n groundmail.dev\n
\n\n---\n\n## Quick start\n\nThe fastest way is the hosted server. Add the URL, sign in through your browser, and you're done. No API key to copy.\n\n```\nhttps://mcp.groundmail.dev/mcp\n```\n\n| Client | How to connect |\n|--------|----------------|\n| **Claude Code** | `claude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp`, then run `/mcp`, pick groundmail and choose Authenticate |\n| **Cursor** | Add `{ \"mcpServers\": { \"groundmail\": { \"url\": \"https://mcp.groundmail.dev/mcp\" } } }` to `.cursor/mcp.json`; Cursor shows \"Needs login\" |\n| **Claude.ai** | Settings → Connectors → Add custom connector → paste the URL |\n| **ChatGPT** | Settings → Apps & Connectors → Create (developer mode) → paste the URL, authentication OAuth |\n\nWhen you connect, you choose the access: **Full**, **Send only** or **Read only**. Revoke it any time in Groundmail under Settings → CLIs & agents.\n\n## What you can ask for\n\n> \"Send a password reset email to ada@example.com from noreply@mail.acme.com.\"\n>\n> \"Did my last 10 emails get delivered? Show any bounces.\"\n>\n> \"Add mail.acme.com as a sending domain and apply the DNS records on Cloudflare.\"\n>\n> \"How is my deliverability over the last 7 days?\"\n\nTools cover emails (send, schedule, cancel, look up), domains (add, apply DNS, verify), templates, webhooks, suppressions and deliverability. Each tool carries read-only and destructive annotations and an output schema. Full list: [docs.groundmail.dev/ai/mcp](https://docs.groundmail.dev/ai/mcp).\n\n## Transports\n\n| Mode | Command / URL | Auth |\n|------|---------------|------|\n| **HTTP (hosted)** | `https://mcp.groundmail.dev/mcp` | **OAuth** (recommended) or `Authorization: Bearer gm_…` |\n| **stdio** | `npx -y groundmail-mcp` | `GROUNDMAIL_API_KEY=gm_…` |\n| **HTTP (local)** | `npx -y groundmail-mcp --http --port 3000` | `Authorization: Bearer gm_…` on each request |\n\nOptional: `GROUNDMAIL_API_URL` (for example `http://localhost:3003/api` against a local API).\n\nLocal HTTP endpoint: `http://127.0.0.1:3000/mcp` · health: `GET /health`\nHosted health: `GET https://mcp.groundmail.dev/health`\n\n