Skip to content
@Groundmail

Groundmail

Email infrastructure for apps and AI agents. SDKs, CLI, MCP server and agent skills.
README.md

Groundmail

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.

Pinned Loading

  1. groundmail-skills groundmail-skills Public

    Agent skills, a Claude Code plugin and a Cursor rule that teach coding agents to add Groundmail to your app and give agents their own mailboxes.

  2. groundmail-sdks groundmail-sdks Public

    Official Groundmail SDKs for Python, Go, Ruby, PHP, Laravel and Symfony Mailer. Send and receive email from your app or AI agent in a few lines of code.

    PHP

  3. groundmail-php groundmail-php Public

    Official PHP SDK for Groundmail, email infrastructure for apps and AI agents. composer require groundmail/groundmail

    PHP

  4. groundmail-laravel groundmail-laravel Public

    Laravel mail transport for Groundmail. Keep Mail::to()->send() and deliver through the Groundmail API.

    PHP

  5. groundmail-mcp groundmail-mcp Public

    MCP server for Groundmail: send and receive email, give agents their own mailboxes and set up domains from Claude, ChatGPT, Cursor and any MCP client. Hosted with OAuth at mcp.groundmail.dev.

    TypeScript

  6. groundmail-nodemailer groundmail-nodemailer Public

    Nodemailer transport for Groundmail: keep transporter.sendMail() and deliver over the Groundmail HTTP API.

    TypeScript 1

Repositories

Showing 10 of 25 repositories
  • groundmail-nodemailer Public

    Nodemailer transport for Groundmail: keep transporter.sendMail() and deliver over the Groundmail HTTP API.

    Groundmail/groundmail-nodemailer's past year of commit activity
    TypeScript 1 MIT 0 0 0 Updated Nov 6, 2026
  • groundmail-mcp Public

    MCP server for Groundmail: send and receive email, give agents their own mailboxes and set up domains from Claude, ChatGPT, Cursor and any MCP client. Hosted with OAuth at mcp.groundmail.dev.

    Groundmail/groundmail-mcp's past year of commit activity
    TypeScript 0 MIT 0 0 0 Updated Nov 6, 2026
  • groundmail-laravel Public

    Laravel mail transport for Groundmail. Keep Mail::to()->send() and deliver through the Groundmail API.

    Groundmail/groundmail-laravel's past year of commit activity
    PHP 0 MIT 0 0 0 Updated Nov 6, 2026
  • groundmail-symfony-mailer Public

    Symfony Mailer transport for Groundmail. Send over the HTTP API with a groundmail+api:// DSN.

    Groundmail/groundmail-symfony-mailer's past year of commit activity
    PHP 0 MIT 0 0 0 Updated Nov 6, 2026
  • groundmail-php Public

    Official PHP SDK for Groundmail, email infrastructure for apps and AI agents. composer require groundmail/groundmail

    Groundmail/groundmail-php's past year of commit activity
    PHP 0 MIT 0 0 0 Updated Nov 6, 2026
  • groundmail-sdks Public

    Official Groundmail SDKs for Python, Go, Ruby, PHP, Laravel and Symfony Mailer. Send and receive email from your app or AI agent in a few lines of code.

    Groundmail/groundmail-sdks's past year of commit activity
    PHP 0 MIT 0 0 0 Updated Nov 6, 2026
  • nestjs-groundmail Public

    NestJS module for Groundmail

    Groundmail/nestjs-groundmail's past year of commit activity
    TypeScript 0 MIT 0 0 0 Updated Nov 6, 2026
  • strapi-provider-email-groundmail Public

    Strapi email provider for Groundmail

    Groundmail/strapi-provider-email-groundmail's past year of commit activity
    TypeScript 0 MIT 0 0 0 Updated Nov 6, 2026
  • medusa-notification-groundmail Public

    Medusa v2 notification provider for Groundmail

    Groundmail/medusa-notification-groundmail's past year of commit activity
    TypeScript 0 MIT 0 0 0 Updated Nov 6, 2026
  • adonisjs-groundmail Public

    AdonisJS mail transport for Groundmail

    Groundmail/adonisjs-groundmail's past year of commit activity
    TypeScript 0 MIT 0 0 0 Updated Nov 6, 2026
View all repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.