groundmail / laravel

v0.8.3 2026-10-16 16:11 UTC

Requires

• php: >=8.1
• groundmail/groundmail: ^0.8.2
• groundmail/symfony-mailer: ^0.8.2
• illuminate/mail: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0
• symfony/mailer: ^6.2|^7.0
• symfony/mime: ^6.2|^7.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• Groundmail

• email
• laravel
• transactional
• groundmail

Published on Packagist.org on 2026-10-16 16:24 UTC

README

Groundmail for Laravel

A Laravel mail transport for the Groundmail transactional email API.
Keep Mail::to()->send(); deliver through Groundmail.

Docs · Get a free account · groundmail.dev

Install

composer require groundmail/laravel

Set in .env:

GROUNDMAIL_API_KEY=gm_your_key_here
MAIL_MAILER=groundmail

Add to config/mail.php:

'groundmail' => [
    'transport' => 'groundmail',
],

Send as usual

Mail::to($user)->send(new WelcomeMail($user));

Your existing Mailables, notifications and queued mail keep working.

Call the API directly

use Groundmail\Laravel\Facades\Groundmail;

Groundmail::client()->emails->send([
    'from' => '[e-mail]',
    'to' => '[e-mail]',
    'subject' => 'Hello',
    'html' => '<p>It works.</p>',
]);

Contributing

Found a bug or want something added? Open an issue. This code is published here on each release, so we port fixes rather than merging pull requests directly.

Why Groundmail

• Our own mail servers and IP space. Your password resets and receipts don't share a pool with bulk marketing senders.
• Transactional email only. No newsletters or cold outreach on the platform, which keeps the sending reputation clean.
• Start free. 3,000 emails a month on the Free plan; Pro is 50,000 emails for $20/month. Dedicated IPs on Scale.
• 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.

All Groundmail libraries

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