AWS SES MCP Server
README.md
# AWS SES MCP Server
[](https://mpak.dev/packages/@nimblebraininc/aws-ses?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses)
[](https://nimblebrain.ai?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses)
[](https://nimblebrain.ai/discord?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses)
[](LICENSE)
A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that sends emails using [AWS Simple Email Service (SES)](https://aws.amazon.com/ses/). Send HTML or plain text emails with CC/BCC support from any MCP client.
**[View on mpak registry](https://mpak.dev/packages/@nimblebraininc/aws-ses?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses)** | **Built by [NimbleBrain](https://nimblebrain.ai?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses)**
## Install
Install with [mpak](https://mpak.dev?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses):
```bash
mpak install @nimblebraininc/aws-ses
```
### Configuration
You need an AWS account with SES enabled, a verified sender email address, and IAM credentials with SES permissions.
```bash
mpak config set @nimblebraininc/aws-ses aws_access_key_id YOUR_ACCESS_KEY
mpak config set @nimblebraininc/aws-ses aws_secret_access_key YOUR_SECRET_KEY
mpak config set @nimblebraininc/aws-ses from_email your-verified@email.com
```
Optionally set the region (defaults to `us-east-1`):
```bash
mpak config set @nimblebraininc/aws-ses aws_region us-west-2
```
### Claude Code
```bash
claude mcp add aws-ses -- mpak run @nimblebraininc/aws-ses
```
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"aws-ses": {
"command": "mpak",
"args": ["run", "@nimblebraininc/aws-ses"]
}
}
}
```
See the [mpak registry page](https://mpak.dev/packages/@nimblebraininc/aws-ses?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses) for full install options.
## Tools
### send_email
Send an email using AWS SES. Supports HTML bodies with automatic plain text fallback.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | `string` | Yes | Recipient email address |
| `subject` | `string` | Yes | Email subject line |
| `body` | `string` | Yes | Email body (HTML supported) |
| `from_email` | `string` | No | Sender email (defaults to `AWS_SES_FROM_EMAIL`) |
| `cc` | `string` | No | CC recipients, comma-separated |
| `bcc` | `string` | No | BCC recipients, comma-separated |
**Example call:**
```json
{
"name": "send_email",
"arguments": {
"to": "recipient@example.com",
"subject": "Weekly Report",
"body": "<h1>Weekly Report</h1><p>Here are this week's highlights...</p>"
}
}
```
**Example response:**
```json
{
"success": true,
"message_id": "0102018f-1234-5678-abcd-example",
"timestamp": "2026-02-13T10:00:00+00:00",
"to": "recipient@example.com",
"subject": "Weekly Report"
}
```
## Quick Start
### Local Development
```bash
git clone https://github.com/NimbleBrainInc/mcp-aws-ses.git
cd mcp-aws-ses
# Install dependencies
uv sync
# Set credentials
cp .env.example .env
# Edit .env with your AWS credentials
# Run the server (stdio mode)
uv run python -m mcp_aws_ses.server
```
The server supports HTTP transport with:
- Health check: `GET /health`
- MCP endpoint: `POST /mcp`
## Development
```bash
# Install with dev dependencies
uv sync --group dev
# Run all checks (format, lint, typecheck, unit tests)
make check
# Run unit tests
make test
# Run with coverage
make test-cov
```
## About
AWS SES MCP Server is published on the [mpak registry](https://mpak.dev?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses) and built by [NimbleBrain](https://nimblebrain.ai?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses). mpak is an open registry for [Model Context Protocol](https://modelcontextprotocol.io) servers.
- [mpak registry](https://mpak.dev?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses)
- [NimbleBrain](https://nimblebrain.ai?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses)
- [MCP specification](https://modelcontextprotocol.io)
- [Discord community](https://nimblebrain.ai/discord?utm_source=github&utm_medium=readme&utm_campaign=mcp-aws-ses)
## License
MIT
TDQS
B3.1/5.0
Scored across 1 tool
Disambiguation5/5
With only one tool, there is no possibility of confusion between tools. The single action is clearly defined.
Naming Consistency5/5
The tool uses a clear verb_noun pattern (send_email), which is predictable and readable. There are no other tools to create inconsistency.
Tool Count3/5
A single tool is quite thin for a server ostensibly covering AWS SES. While send_email is a core operation, the surface feels under-scoped.
Completeness2/5
SES involves identity verification, template management, and bulk sending, none of which are exposed. The tool set only covers one basic operation, leaving significant lifecycle gaps.
Maintenance
ActivityMaintained
ResponsivenessOutdated data