Teach Claude Code, Cursor, Codex and other coding agents to add Groundmail to your app.
Agent skills, plugins for Claude Code, Cursor and Codex, and a Cursor rule for the Groundmail email API.
Docs · Get a free account · groundmail.dev
| What | Install |
|---|---|
| Agent Skills (Claude Code, Cursor, Codex, Gemini CLI and more) | npx skills add Groundmail/groundmail-skills -y |
| Claude Code plugin (skills + hosted MCP) | /plugin marketplace add Groundmail/groundmail-skills then /plugin install groundmail@groundmail |
| Codex plugin (skills + hosted MCP) | codex plugin marketplace add Groundmail/groundmail-skills, then /plugins in Codex and install Groundmail |
| Cursor rule | curl -fsSL https://docs.groundmail.dev/ai/groundmail.mdc?utm_source=github&utm_medium=readme&utm_campaign=groundmail-skills -o .cursor/rules/groundmail.mdc |
| MCP server only | claude mcp add --transport http groundmail https://mcp.groundmail.dev/mcp |
Then ask your agent something like:
"Add Groundmail to this app and send a password reset email through it."
The agent signs in through your browser with groundmail login, so there's no API key to paste into chat.
| Skill | Use it for |
|---|---|
groundmail |
Sending with the API, an official SDK (Node, Python, Go, PHP, Ruby), or SMTP; test sends; idempotency; error codes |
groundmail-mcp |
Connecting the MCP server in Claude, Claude Code, ChatGPT and Cursor |
groundmail-cli |
Terminal workflows with the groundmail CLI |
email-best-practices |
DNS (SPF, DKIM, DMARC), suppressions, key hygiene and deliverability |
- Skills: the four Markdown skills above. They contain instructions and code examples only; nothing in them runs on install.
- MCP server: one remote server,
https://mcp.groundmail.dev/mcp. You sign in with your Groundmail account in the browser and choose Full, Send only or Read only access. Tool calls go to Groundmail and act on your account: sending and looking up email, domains, templates, webhooks and suppressions. Revoke access any time in the Groundmail dashboard under Settings → CLIs & agents. - Cursor rule:
rules/groundmail.mdc, the same guidance as thegroundmailskill.
No hooks, no scripts and no local packages. When the agent writes code that uses Groundmail, that code calls https://api.groundmail.dev with your API key, the same as any integration you write yourself. Privacy policy · Terms
Agent index for any model: docs.groundmail.dev/llms.txt
- Separate streams. Your sign-in codes never wait behind a newsletter.
- We run the servers. Our own mail servers and IP space, so we can see and fix delivery problems ourselves.
- Start free. Free covers 3,000 emails a month. After that, pay as you go is $15 a month with 20,000 emails included, then from $0.70 per 1,000, less as you grow. Pricing
- Built for code and for agents. REST API, SMTP, SDKs for Node, Python, Go, PHP and Ruby, a CLI, and an MCP server for Claude, ChatGPT and Cursor.
| Use | Package |
|---|---|
| Node.js / TypeScript | groundmail on npm |
| Python (Django), Go, Ruby (Rails Action Mailer) | Groundmail/groundmail-sdks |
| PHP | Groundmail/groundmail-php |
| Laravel | Groundmail/groundmail-laravel |
| Symfony Mailer | Groundmail/groundmail-symfony-mailer |
| Nodemailer | Groundmail/groundmail-nodemailer |
| NestJS | Groundmail/nestjs-groundmail |
| Strapi | Groundmail/strapi-provider-email-groundmail |
| Medusa | Groundmail/medusa-notification-groundmail |
| AdonisJS | Groundmail/adonisjs-groundmail |
| Phoenix (Swoosh) | Groundmail/swoosh_groundmail |
| CLI | groundmail-cli on npm |
| MCP server (Claude, ChatGPT, Cursor) | Groundmail/groundmail-mcp |
| Agent skills and Claude Code plugin | Groundmail/groundmail-skills |
| Email templates (React Email, MJML, HTML) | Groundmail/email-templates |
Website · Docs · Pricing · Sign up free