AWS SES

This is a simple Model Context Protocol (MCP) server that sends emails using AWS SES (Simple Email Service). Perfect for integrating with Cursor or Claude Desktop to compose and send emails directly without copy-pasting. The service supports both plain text and HTML emails with advanced features like CC, BCC, and reply-to functionality.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 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": {
    "omd01-aws-ses-mcp": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js",
        "--aws-access-key-id=YOUR_AWS_ACCESS_KEY_ID",
        "--aws-secret-access-key=YOUR_AWS_SECRET_ACCESS_KEY",
        "--aws-region=YOUR_AWS_REGION",
        "--sender=YOUR_SENDER_EMAIL",
        "--reply-to=REPLY_TO_EMAIL"
      ],
      "env": {
        "AWS_REGION": "YOUR_AWS_REGION",
        "AWS_ACCESS_KEY_ID": "YOUR_AWS_ACCESS_KEY_ID",
        "SENDER_EMAIL_ADDRESS": "YOUR_SENDER_EMAIL",
        "AWS_SECRET_ACCESS_KEY": "YOUR_AWS_SECRET_ACCESS_KEY",
        "REPLY_TO_EMAIL_ADDRESSES": "REPLY_TO_EMAILS_COMMA_SEPARATED"
      }
    }
  }
}

This MCP server lets you send emails through AWS SES directly from your preferred MCP clients. It supports plain text and HTML content, CC/BCC recipients, configurable reply-to addresses, and is designed to log requests for debugging while enabling email scheduling.

How to use

You can connect this MCP server to your MCP client (such as Cursor or Claude Desktop) to compose and send emails without leaving the chat or editor. Provide the required AWS SES credentials and sender address, then issue an email command from your client to dispatch messages. You can include to, subject, text or HTML content, CC and BCC recipients, and an optional reply-to address. If you need to schedule emails, use the built-in scheduling feature to specify a delivery time. All requests and responses are logged for troubleshooting.

How to install

Prerequisites you need before installing this MCP server: Node.js installed on your system and an AWS SES setup with verified sender addresses or domains. You will also need AWS credentials with SES permissions.

Concrete steps to install locally:

# 1) Clone the project
git clone https://github.com/omd01/aws-ses-mcp.git
cd aws-ses-mcp

# 2) Install dependencies
npm install

# 3) Build the project
npm run build

Configuration

Example email payload you can prepare in email.md shows the required fields: to, subject, text, and optional cc and bcc. Use this format as your starting point when composing emails to send through AWS SES.

Additionally, you pass credentials and sender information when launching the MCP server. The recommended runtime configuration is to run the MCP server as a local process and supply credentials and settings via command-line flags or environment variables.

{
  "to": "example@gmail.com",
  "subject": "Test!",
  "text": "This is a test email.",
  "cc": ["cc-recipient@example.com"],
  "bcc": ["bcc-recipient@example.com"]
}

Security and notes

Ensure your sender email address or domain is verified in AWS SES before dispatching emails. Keep AWS access keys secure and avoid hard-coding them in your client-side configurations. Use environment variables or secret management where possible.

This server logs full request/response activity to help you diagnose issues. If you encounter delivery failures, review the AWS SES console for bounces or complaints and verify that your SES sandbox or production settings are correctly configured.

Troubleshooting

If emails are not sending, double-check your AWS credentials and SES permissions. Verify that the sender address is verified in SES, and inspect the logs for any error messages or rejected recipients.

Notes

You can integrate this MCP server with Cursor or Claude Desktop by configuring a local MCP server entry that runs the server binary with the appropriate arguments or environment variables.

Available tools

sendEmail

Dispatches an email to one or more recipients with options for CC, BCC, and reply-to. Supports both plain text and HTML content.

scheduleEmail

Schedules an email to be delivered at a specified time in the future.

logRequests

Logs full request and response data for debugging and auditing.

verifySender

Ensures the sender email/address is verified in SES before sending.

setReplyTo

Configures reply-to addresses for outgoing emails.

Built by

VeilStrat

AI signals for GTM teams