SendGrid MCP Server — Hosted Notifications Integration
MCP Server language Hosted language PublicSend emails at scale, manage dynamic templates, and track delivery stats via SendGrid's email infrastructure.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"sendgrid": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-sendgrid",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify sendgrid credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
mcp-sendgrid — SendGrid MCP Server
Send transactional and marketing emails at scale — let AI agents trigger emails, manage templates, maintain contact lists, and monitor deliverability via SendGrid.
SendGrid powers email delivery for over 80,000 companies, sending billions of emails every month. This MCP server gives your agents the full SendGrid v3 API: sending single and bulk emails with dynamic templates, managing marketing contacts and lists, pulling delivery and engagement stats, monitoring bounces, and managing verified sender identities.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-sendgrid
What You Can Do
- Send transactional emails from any trigger — signups, payments, errors, or alerts — with dynamic template data
- Send personalized bulk emails to thousands of recipients with per-recipient template variables
- Monitor email deliverability with global stats, bounce lists, and per-template analytics
- Maintain marketing contact lists and sync subscribers from your application automatically
Available Tools
| Tool | Description |
|---|---|
| send_email | Send a transactional email with HTML/text content, CC, BCC, and dynamic template support |
| send_bulk_email | Send to multiple recipients with per-recipient dynamic template data (up to 1000) |
| send_template_email | Simplified tool to send a dynamic template email with substitution data |
| schedule_email | Schedule an email to send at a specific Unix timestamp (up to 72 hours ahead) |
| list_templates | List all dynamic transactional email templates |
| get_template | Get full details of a template including all versions |
| create_template | Create a new dynamic transactional email template |
| get_template_version | Get a specific template version with HTML content and subject |
| search_contacts | Search marketing contacts using SGQL query language |
| get_contact | Get full details of a marketing contact by ID |
| upsert_contacts | Create or update one or more marketing contacts by email |
| list_contact_lists | List all marketing contact lists |
| add_contacts_to_list | Add contacts to a specific marketing list by contact ID |
| get_global_stats | Get global email stats (sends, opens, clicks, bounces) for a date range |
| get_email_stats | Get stats filtered by category for a date range |
| get_template_stats | Get delivery and engagement stats for a specific template version |
| get_bounce_list | Get bounced email addresses with reason and timestamp |
| list_senders | List all verified sender identities |
| create_sender | Create a new sender identity (requires email verification) |
| verify_sender_domain | Validate DNS records (DKIM, SPF) for an authenticated domain |
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
| SENDGRID_API_KEY | Yes | SendGrid API key with Mail Send and Marketing permissions | app.sendgrid.com → Settings → API Keys → Create API Key |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "SendGrid" and click Add to Workspace
- Add your
SENDGRID_API_KEYunder Project → Secrets
Once added, every AI agent in your workspace can send and manage emails via SendGrid automatically — no per-user setup needed.
Example Prompts
"Send a welcome email to new user alice@example.com using template d-abc123 with her first name 'Alice'"
"Show me the email open rate and click rate for the past 7 days"
"Sync the new customer list and add all emails to the 'Active Customers' marketing list"
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-sendgrid \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-SENDGRID-API-KEY: your-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"send_email","arguments":{"to":"alice@example.com","from":"hello@yourapp.com","subject":"Welcome!","content":[{"type":"text/plain","value":"Thanks for signing up!"}]}}}'
License
MIT
terminal Tools (21)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
_ping #1 Verify SendGrid credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.
send_email #2 Send a transactional email via SendGrid. Supports plain text and HTML content, CC, BCC, reply-to, dynamic templates, and custom template data.
send_bulk_email #3 Send the same email to multiple recipients using personalizations. Each recipient can have unique dynamic_template_data. Supports up to 1000 recipients per call.
send_template_email #4 Simplified tool to send an email using a SendGrid dynamic template. Just provide the template ID, recipient, sender, and template data.
schedule_email #5 Schedule an email to be sent at a specific future time. Uses a Unix timestamp for the send_at field. SendGrid allows scheduling up to 72 hours in advance.
list_templates #6 List all dynamic transactional email templates in your SendGrid account.
get_template #7 Get full details of a specific SendGrid template including all versions.
create_template #8 Create a new dynamic transactional email template in SendGrid.
get_template_version #9 Get a specific version of a template, including the HTML/text content and subject.
search_contacts #10 Search your SendGrid marketing contacts using SGQL (SendGrid Query Language). Supports filtering by email, first_name, last_name, custom fields, and list membership.
get_contact #11 Get full details of a specific contact by their SendGrid contact ID.
upsert_contacts #12 Create or update (upsert) one or more marketing contacts. If a contact with the email already exists, it is updated; otherwise it is created. Asynchronous — returns a job_id.
list_contact_lists #13 List all contact lists (segments/audiences) in your SendGrid Marketing account.
add_contacts_to_list #14 Add one or more contacts (by their contact IDs) to a specific marketing list.
get_global_stats #15 Get global email statistics (sends, deliveries, opens, clicks, bounces, spam reports) across all emails for a date range.
get_email_stats #16 Get email statistics filtered by category for a date range.
get_template_stats #17 Get delivery and engagement statistics for a specific template version.
get_bounce_list #18 Get the list of email addresses that have bounced. Includes bounce reason and timestamp.
list_senders #19 List all verified sender identities in your SendGrid account. Shows verification status.
create_sender #20 Create a new sender identity in SendGrid. The sender must complete email verification before it can be used to send emails.
verify_sender_domain #21 Trigger domain authentication validation for a whitelabeled domain. Checks that DNS records (DKIM, SPF) are correctly configured.
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-sendgrid
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in Notifications
Browse Notifications MCPs →Pusher
by @aerostack
Trigger real-time events to browser and mobile clients, manage presence channels, and authenticate sockets via Pusher.
Resend
by @aerostack
Send transactional emails with developer-grade deliverability — manage domains, API keys, and sending stats via Resend.
Twilio
by @aerostack
Send SMS, make calls, and manage phone numbers via Twilio — add programmable communications to any AI workflow.
Omnisend
by @aerostack
Drive ecommerce growth with Omnisend — manage contacts, campaigns, automations, segments, and track events from AI.
Sendbird
by @aerostack
Sendbird in-app messaging MCP — manage channels, messages, and users via the Sendbird platform API
Frequently asked questions
What is the SendGrid MCP server and what can it do? +
The SendGrid MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `send_email`, `send_bulk_email`, `send_template_email`, `schedule_email`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the SendGrid MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the SendGrid MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same SendGrid MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the SendGrid MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-sendgrid": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-sendgrid"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the SendGrid MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-sendgrid", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-sendgrid"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does SendGrid MCP require authentication? +
Yes. SendGrid requires authentication. Check the MCP's documentation for the required credentials.