Website
SendGrid
Transactional and marketing email service by Twilio. Send emails with high deliverability, templates, and analytics.
🔑 Setup Required — Bring Your Own Key
This integration requires API credentials. Store them once via
setup_integration or the Dashboard Vault — they're encrypted
with AES-256-GCM and never exposed.
Required Credentials
sendgrid_api_key
API Key
Find your API key at app.sendgrid.com → Settings → API Keys. Keys start with "SG."
Get your API key at sendgrid.com →
Endpoints (1)
POST
send-email
Send a transactional email via SendGrid. Uses the v3 mail/send endpoint with personalizations for recipient handling.
| Field | Type | Required | Description |
|---|---|---|---|
personalizations |
array | ✓ Yes | Array of recipient objects. Each needs a "to" array with {"email": "...", "name": "..."} objects. Can include per-recipient "subject" and "dynamic_template_data". Example: [{"to": [{"email": "user@example.com", "name": "User"}]}] |
from |
array | ✓ Yes | Sender object with "email" (required) and "name" (optional). Must be a verified sender. Example: {"email": "noreply@yourdomain.com", "name": "Your App"} |
subject |
string | No | Global email subject line. Can be overridden per personalization. |
content |
array | No | Array of content objects. Each has "type" (e.g. "text/plain", "text/html") and "value" (the content). Example: [{"type": "text/html", "value": "<h1>Hello</h1>"}] |
reply_to |
array | No | Reply-to object with "email" and optional "name" |
template_id |
string | No | ID of a dynamic template to use (starts with "d-"). When used, content is optional. |
categories |
array | No | Array of category strings for tracking (max 10 categories, max 255 chars each) |
send_at |
integer | No | Unix timestamp to schedule email delivery (up to 72 hours in advance) |
attachments |
array | No | File attachments: [{ filename, content_base64, mime_type }]. |
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| send-email | sendgrid_send_email |