mcp-email-sendgrid-template

i-dream-of-ai/mcp-email-sendgrid-template

3.1

If you are the rightful owner of mcp-email-sendgrid-template and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP SendGrid Email Server is a Model Context Protocol server designed for sending emails using the SendGrid API, offering full compliance with JSON-RPC 2.0 and robust error handling.

Tools
4
Resources
0
Prompts
0

MCP SendGrid Email Server

A Model Context Protocol (MCP) server for sending emails via SendGrid API.

Features

  • 🚀 Full MCP Protocol Compliance - JSON-RPC 2.0 with proper error handling
  • 📧 SendGrid Integration - Send transactional and marketing emails
  • 🔧 Multiple Tools - Single emails, bulk emails, template support
  • ⚡ Cloudflare Workers - Fast, global edge deployment
  • 🔒 Type Safe - Full TypeScript with Zod validation

Available Tools

send_email

Send a single email to one or more recipients.

Parameters:

  • to: Array of recipient email addresses
  • subject: Email subject line
  • body: Email body (HTML or plain text)
  • from: Sender email (optional, uses default)
  • replyTo: Reply-to address (optional)

send_bulk_email

Send personalized emails to multiple recipients.

Parameters:

  • recipients: Array of {email, data} objects
  • templateId: SendGrid template ID
  • globalData: Data available to all recipients

get_templates

List available SendGrid templates.

get_email_status

Check delivery status of sent emails.

Setup

1. Set up GitHub Actions (Optional)

To enable automatic deployment, move the deploy.yml file to .github/workflows/deploy.yml:

```bash mkdir -p .github/workflows mv deploy.yml .github/workflows/deploy.yml ```

Or deploy manually using the Cloudflare Workers button:

Deploy to Cloudflare Workers

2. Configure Environment Variables

Set these in your Cloudflare Workers dashboard or via GitHub secrets:

  • SENDGRID_API_KEY: Your SendGrid API key
  • EMAIL_DEFAULT_FROM: Default sender email address

3. Connect to Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "email": {
      "url": "https://your-worker.workers.dev",
      "transport": "http"
    }
  }
}

Usage Examples

Send a Simple Email

Please send an email to john@example.com with subject "Meeting Tomorrow" and body "Don't forget our 2pm meeting"

Send Marketing Email with Template

Send our weekly newsletter template to all subscribers in the marketing list

Bulk Personalized Emails

Send welcome emails to these new users: [list] using the welcome template

Local Development

  1. Clone this repository
  2. Install dependencies: npm install
  3. Copy wrangler.toml.example to wrangler.toml
  4. Set your SendGrid API key in wrangler.toml
  5. Run locally: npm run dev
  6. Deploy: npm run deploy

Error Handling

The server provides detailed error messages for:

  • Invalid email addresses
  • Missing API keys
  • SendGrid API failures
  • Rate limiting
  • Template not found

Support

For issues or questions: