SendGrid MCP
About
Transactional SendGrid MCP: preflight send, templates, delivery diagnostics, account/console settings, optional Event Webhook receiver. Self-hosted binary, BYOK.
Details
- Author
- neschadin
- Categories
- Communication, Automation, API
Jump to
Setup
Install SendGrid MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/neschadin/sendgrid-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
End users run a single compiled binary — Bun is not required.
Contact/list marketing CRUD is intentionally out of scope.
This project is community-maintained and is not affiliated with, endorsed by, or sponsored by Twilio SendGrid.
- Safe send—sendgrid_validate_send_request,sendgrid_send_with_preflight, sandbox mode
- Templates— list/create/update/activate dynamic templates
- Diagnostics— Email Activity, suppressions, stats, error classification, delivery triage
- Webhooks— Event Webhook config in SendGrid + optional local receiver (ngrok-friendly)
- Account & console— verified senders, domain auth, mail/tracking settings, alerts, inbound parse
Download the binary for your OS fromGitHub Releases.
chmod +x sendgrid-linux-x64 mv sendgrid-linux-x64 ~/.local/bin/sendgrid
The binary is built withbun build --compileandembeds the Bun runtime. Users do not install Bun.
Each user runs the server locally withtheir ownAPI key (bring-your-own-key). Do not share one hosted instance with shared credentials.
Enabled only whenSENDGRID_EVENT_WEBHOOK_PORTis set.
Point SendGrid Event Webhook URL to your tunnel, e.g.https://<ngrok-host>/sendgrid/events. Inspect events via MCP toolsget_received_webhook_events/get_webhook_receiver_status.
For public tunnels, prefer signed webhook verification:SENDGRID_EVENT_WEBHOOK_REQUIRE_SIGNATURE=trueandSENDGRID_EVENT_WEBHOOK_PUBLIC_KEY=<SendGrid public key>.
Settings → MCP → add server (or edit~/.cursor/mcp.json):
{ "mcpServers": { "sendgrid": { "command": "/absolute/path/to/sendgrid", "args": [], "env": { "SENDGRID_API_KEY": "SG.xxx", "SENDGRID_FROM_EMAIL": "you@yourdomain.com", "SENDGRID_FROM_NAME": "Your App" } } } }
{ "mcpServers": { "sendgrid": { "command": "/absolute/path/to/sendgrid", "args": [], "env": { "SENDGRID_API_KEY": "SG.xxx", "SENDGRID_FROM_EMAIL": "you@yourdomain.com" } } } }
Restart the client after changing MCP config.
- Send toolscan enqueue real email. Prefersendgrid_send_with_preflightin automation.
- Mutating console toolsrequireconfirmToken: "CONFIRM"(alerts, mail/tracking settings, verified senders, domains, webhooks).
- Email Activity(/v3/messages) may require theEmail Activity add-on.
- MCP server name:sendgrid-mcp-server
- All tool names are prefixed:sendgrid_<name>(e.g.sendgrid_validate_send_request)
- List/read tools accept optionalresponse_format(markdown|json) and return pagination metadata on list tools
Bun is only needed tobuild from source, not to run the release binary.
git clone https://github.com/Neschadin/sendgrid-mcp.git cd sendgrid-mcp bun install bun run dev # stdio MCP from TypeScript bun run build # compile → bin/sendgrid (local platform) ./scripts/build-release.sh # all release targets → dist/ bun run lint bun run typecheck:tsc # bun build graph + unit tests bun run smoke bun test tests
SENDGRID_API_KEY=SG.xxx SENDGRID_FROM_EMAIL=you@domain.com bun run inspect
- MCP_TOOLS.md— tools, runbooks, risk matrix
- SendGrid API reference
- SendGrid for developers
Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.
Send emails directly from your editor using the Resend API.
Sendmux is an email inbox API and email API for AI agents.
Self-hosted email and SMS platform for AI agents — each agent gets a real email address, phone number, inbox, and API key.
Give your AI agent its own email address — instant bot inboxes via API, no human setup required.
Sends emails using the Resend API. Requires a Resend API key.
Context Intelligence API that returns structured, cited answers from email threads, attachments, and Google Drive docs in one API call.
An MCP server for sending emails via the Postmark service, configured through environment variables.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
