AWS SES Server

mpak NimbleBrain Discord License: MIT

A Model Context Protocol (MCP) server that sends emails using AWS Simple Email Service (SES). Send HTML or plain text emails with CC/BCC support from any MCP client.

View on mpak registry | Built by NimbleBrain

Install

Install with mpak:

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.

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 [email protected]

Optionally set the region (defaults to us-east-1):

mpak config set @nimblebraininc/aws-ses aws_region us-west-2

Claude Code

claude mcp add aws-ses -- mpak run @nimblebraininc/aws-ses

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "aws-ses": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/aws-ses"]
    }
  }
}

See the mpak registry page 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:

{
  "name": "send_email",
  "arguments": {
    "to": "[email protected]",
    "subject": "Weekly Report",
    "body": "<h1>Weekly Report</h1><p>Here are this week's highlights...</p>"
  }
}

Example response:

{
  "success": true,
  "message_id": "0102018f-1234-5678-abcd-example",
  "timestamp": "2026-02-13T10:00:00+00:00",
  "to": "[email protected]",
  "subject": "Weekly Report"
}

Quick Start

Local Development

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

# 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 and built by NimbleBrain. mpak is an open registry for Model Context Protocol servers.

• mpak registry
• NimbleBrain
• MCP specification
• Discord community

License

MIT