AWS SES MCP

aws-ses-mcp 📧

This is a simple 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.

Features ✨

Send plain text and HTML emails
Support for CC and BCC recipients
Configurable reply-to addresses
Customizable sender email (requires AWS SES verification)
Full request/response logging for debugging
Email scheduling capability

Prerequisites 📋

Before you begin, ensure you have:

AWS SES account set up and configured
Verified email domain or individual email addresses in AWS SES
AWS credentials (Access Key ID and Secret Access Key) with SES permissions
Node.js installed on your system

Installation 🚀

Installing via Smithery

To install aws-ses-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @omd01/aws-ses-mcp --client claude

Manual Installation

Clone this repository:

git clone https://github.com/omd01/aws-ses-mcp.git
cd aws-ses-mcp

Install dependencies:

npm install

Build the project:

npm run build

Configuration ⚙️

Example Email Format (email.md)

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

Setup Instructions 🔧

For Cursor

Go to Cursor Settings -> MCP -> Add new MCP server
Configure the server with these settings:
- Name: aws-ses-mcp (or your preferred name)
- Type: command
- Command:
node 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

For Claude Desktop

Add the following configuration to your MCP config:

{
  "mcpServers": {
    "aws-ses-mcp": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_AWS_ACCESS_KEY_ID",
        "AWS_SECRET_ACCESS_KEY": "YOUR_AWS_SECRET_ACCESS_KEY",
        "AWS_REGION": "YOUR_AWS_REGION",
        "SENDER_EMAIL_ADDRESS": "YOUR_SENDER_EMAIL",
        "REPLY_TO_EMAIL_ADDRESSES": "REPLY_TO_EMAILS_COMMA_SEPARATED"
      }
    }
  }
}

Usage 📝

Create or edit email.md with your email content
In Cursor:
- Open the email.md file
- Select the content
- Press cmd+l (or ctrl+l)
- Tell Cursor to "send this as an email"
- Ensure Cursor chat is in Agent mode

Development 👩‍💻

npm install    # Install dependencies
npm run build  # Build the project

Troubleshooting 🔍

Check the console logs for detailed request/response information
Verify your AWS credentials and permissions
Ensure your sender email is verified in AWS SES
Review the AWS SES console for any bounces or complaints

Contributing 🤝

Contributions are welcome! Please feel free to submit a Pull Request.

License 📄

This project is licensed under the MIT License - see the LICENSE file for details.

The MIT License is a permissive license that is short and to the point. It lets people do anything they want with your code as long as they provide attribution back to you and don't hold you liable.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that enables sending emails directly through AWS SES without copy-pasting, supporting plain text and HTML emails with features like CC, BCC, and reply-to functionality.

Related MCP Servers

Email Sending MCP
resend
A
security
F
license
A
quality
A simple MCP server that enables users to send emails using Resend's API, integrating with tools like Cursor and Claude Desktop for seamless email composition and delivery.
Last updated -
1
4
386
TypeScript
s3-tools
sofianhamiti
A
security
F
license
A
quality
An MCP server that provides tools for interacting with AWS S3 buckets, enabling direct access to S3 operations through the Model Context Protocol.
Last updated -
1
Python
MailPace MCP Serverofficial
mailpace
A
security
A
license
A
quality
An MCP server implementation that allows sending emails over MailPace's fast transactional email API.
Last updated -
1
1
TypeScript
MIT License
Email MCP Server
TimeCyber
A
security
A
license
A
quality
An MCP service that enables AI to fully manage email accounts, supporting sending emails with attachments and multiple recipients across various email providers.
Last updated -
7
8
7
JavaScript
MIT License

View all related MCP servers