Groundmail

[

](https://groundmail.dev/?utm_source=github&utm_medium=readme&utm_campaign=org-profile)

Email infrastructure for apps and AI agents.
Send and receive email from your app or AI agent.

Website · Docs · Pricing · Sign up free

---

Send your first email

npm install groundmail

import { Groundmail } from 'groundmail'

const groundmail = new Groundmail(process.env.GROUNDMAIL_API_KEY)

await groundmail.emails.send({
  from: 'hello@mail.yourcompany.com',
  to: 'ada@example.com',
  subject: 'Reset your password',
  html: '<p>Click the link to reset it.</p>',
})

Or let your coding agent do it: npx skills add Groundmail/groundmail-skills -y, then ask it to "add Groundmail to this app".

Give your agent an email address

npx groundmail-cli mailboxes create --instant

That's a real address your agent can read and reply from, with no account or DNS needed to start. Mail can wake your agent by webhook, and you choose who's allowed to reach it.

Libraries and tools

Node.js / TypeScript	groundmail
Python, Go, Ruby	groundmail-sdks
PHP · Laravel · Symfony	groundmail-php · groundmail-laravel · groundmail-symfony-mailer
Nodemailer	groundmail-nodemailer
CLI	groundmail-cli
MCP server for Claude, ChatGPT and Cursor	groundmail-mcp · hosted at https://mcp.groundmail.dev/mcp
Agent skills and Claude Code plugin	groundmail-skills
Email templates in React Email, MJML and HTML	email-templates · preview

Why Groundmail

• Separate streams. Your sign-in codes never wait behind a newsletter.
• Everything around sending. Inbound, templates, automations, webhooks and agent mailboxes.
• We run the servers. Our own mail servers and IP space, so we can see and fix delivery problems ourselves.
• Start free. 3,000 emails a month, no time limit. Then $15 a month with 20,000 emails included.
• Switching? Migration guides for SendGrid, Postmark and Amazon SES.