SendGrid

MCP server that enables email sending, template management, and statistics via the SendGrid API v3.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "recepyavuz0-sendgrid-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "sendgrid-api-mcp-server"
      ],
      "env": {
        "FROM_EMAIL": "your_email@domain.com",
        "SENDGRID_API_KEY": "YOUR_API_KEY_PLACEHOLDER"
      }
    }
  }
}

This MCP server integrates with SendGrid API v3 to let your AI assistants send emails, manage templates, and view statistics. It enables single and batch emails, template-based messages, scheduled sends, and detailed reporting, all through a simple MCP interface you can use from your preferred client.

How to use

You interact with the SendGrid MCP server through your MCP client. Start the server locally and connect your client using the configured MCP entry. Once connected, you can issue high-level actions such as sending a simple email, sending with a template, batching emails, listing or creating templates, scheduling emails, and retrieving statistics.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

# Step 1: Clone the project
git clone https://github.com/recepyavuz0/sendgrid-mcp-server.git
cd sendgrid-mcp-server

# Step 2: Install dependencies
npm install

# Step 3: Create environment variables
# Replace with your actual values
echo 'SENDGRID_API_KEY=your_sendgrid_api_key_here
FROM_EMAIL=your_verified_sender_email@domain.com' > .env

# Step 4: Build the project
npm run build

# Step 5: Start the MCP server (stdio mode via npm start)
npm start

Additional content

Configuration and usage details are provided through the MCP client you choose. The server exposes tools to send emails, manage templates, and retrieve statistics. This section summarizes the supported capabilities and how to use them through an MCP client.

Environment variables shown in the configuration are required to run the server. Keep your API key secure and avoid sharing your environment file. If you deploy to a shared environment, consider using secret management for the API key and sender email.

Available tools

sendEmail

Send a single email with plain text or HTML content to a recipient.

sendEmailWithTemplate

Send a dynamic email using a pre-built SendGrid template with variable data.

sendBatchEmails

Send the same email to multiple recipients in a single operation.

listTemplates

Retrieve the list of existing email templates.

getStats

Fetch email statistics for a specified date range and aggregation.

scheduleEmail

Schedule an email to be sent at a future timestamp.

createTemplate

Create a new dynamic email template with HTML and plain text bodies.