MCP 服务器

AWS SES MCP Server

Sends emails using AWS Simple Email Service (SES) with support for HTML/plain text, CC, and BCC from any MCP client.

README

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