aws-ses-mcp
If you are the rightful owner of aws-ses-mcp 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.
aws-ses-mcp is a Model Context Protocol server designed to send emails using AWS SES, supporting both plain text and HTML formats with advanced email features.
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 - Name:
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.mdwith 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 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.
