AWS SES MCP Server

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 your-verified@email.com

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": "recipient@example.com",
    "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": "recipient@example.com",
  "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.

License

MIT

AWS SES

README