| name | mcp-sendgrid |
| description | SendGrid MCP wrapper. Activate for transactional email, marketing campaigns, deliverability checks, or list management. Routes to MCP tools if available, else generates email templates for manual send. |
| allowed-tools | Read, Bash, Write |
MCP SendGrid Wrapper
SendGrid email API integration. Bring your own MCP server — this skill documents the tools + manual fallback.
MCP Server
Server command: npx -y @modelcontextprotocol/server-sendgrid (or community equivalent)
Required env: SENDGRID_API_KEY, optional SENDGRID_FROM_EMAIL (default sender)
Setup: SendGrid API keys
Tools exposed (when MCP configured)
| Tool | Purpose |
|---|
mcp__sendgrid__sendEmail | Send transactional email (to, subject, html, attachments) |
mcp__sendgrid__sendBulkEmail | Send to list of recipients (personalization supported) |
mcp__sendgrid__createTemplate | Create reusable email template |
mcp__sendgrid__listTemplates | List all templates |
mcp__sendgrid__addContact | Add to contact list |
mcp__sendgrid__getStats | Delivery, open, click, bounce, spam reports |
Common use patterns
Send welcome email
Tool: mcp__sendgrid__sendEmail
Args: { to: "user@example.com", from: "hello@brand.com", subject: "Welcome!", html: "<h1>Hi!</h1>..." }
Create drip campaign template
Tool: mcp__sendgrid__createTemplate
Args: { name: "Welcome Drip - Email 1", subject: "Getting started", html: "...", design: "..." }
Campaign stats
Tool: mcp__sendgrid__getStats
Args: { startDate: "2026-05-01", endDate: "2026-06-06", aggregation: "day" }
Error handling
| Error | Cause | Fix |
|---|
401 Unauthorized | Invalid SENDGRID_API_KEY | Regenerate key, update env |
403 Forbidden | Sender not verified | Verify sender in SendGrid → Settings → Sender Auth |
413 Payload Too Large | Email > 30MB | Reduce attachment size, use link instead |
429 Too Many Requests | Rate limit (100/sec default) | Implement backoff, batch sends |
Manual Fallback (no MCP server)
If mcp__sendgrid__* tools not available:
- Generate email templates as HTML files in
plans/marketing/<campaign>/emails/<name>.html
- Save personalization placeholders ({{first_name}}, {{company}}, etc.)
- Provide sending instructions to user:
- Copy HTML to SendGrid dashboard → Marketing → Templates
- Upload contact list (CSV with required columns)
- Schedule or send
Template structure:
<!DOCTYPE html>
<html>
<head><title>{{subject}}</title></head>
<body>
<h1>Hi {{first_name}},</h1>
<p>...</p>
<a href="{{cta_url}}" class="cta">Get Started</a>
</body>
</html>
Cross-references
skills/marketing/emails/SKILL.md — email marketing methodology
skills/marketing/email-sequence/SKILL.md — drip sequences
skills/automation/mcp-resend/SKILL.md — alternative (developer-first email API)