email — Claude Code MCP server: what it does, how to install
Connects an AI agent to your Amazon SES account for email delivery, domain checks, and sandbox status. Useful when mail actions must run through AWS.
claude mcp add --env AWS_REGION=<AWS_REGION> --env AWS_PROFILE=<AWS_PROFILE> --env WRAPS_WRITE_ENABLED=<WRAPS_WRITE_ENABLED> --env WRAPS_FROM_EMAIL=<WRAPS_FROM_EMAIL> --env WRAPS_ALLOWED_RECIPIENTS=<WRAPS_ALLOWED_RECIPIENTS> --transport stdio mcp -- npx -y @wraps.dev/mcpWhat email does
email runs locally over stdio and exposes tools for sending messages through Amazon SES, checking domain verification and DKIM, viewing suppressed addresses, and inspecting SES sandbox status. It can also estimate sending costs. Recent-send history and full delivery events require the Wraps event pipeline, initialized with npx @wraps.dev/cli email init.
Set up AWS credentials and an SES account in the target region before starting. Sending is off until WRAPS_WRITE_ENABLED=true is set, and the sender must use a domain verified in SES. Recipient scope can be limited with WRAPS_ALLOWED_RECIPIENTS, WRAPS_ALLOWED_RECIPIENT_DOMAINS, and WRAPS_MAX_RECIPIENTS. The server exits at startup when no region is supplied through AWS_REGION, AWS_DEFAULT_REGION, or the active AWS profile.
What it helps with
- send transactional email through Amazon SES
- check a sending domain’s verification and DKIM state
- inspect addresses on the SES suppression list
- find out whether the account remains in the SES sandbox
- retrieve delivery events for a message
Example prompts for the agent
- Send a transactional email through SES with the subject “Invoice ready” and use the configured sender.
- Check verification and DKIM for the domain
example.com. - Tell me whether this SES account is in the sandbox and what the next first-send step is.
How to install email
Platform CLI
claude mcp add --env AWS_REGION=<AWS_REGION> --env AWS_PROFILE=<AWS_PROFILE> --env WRAPS_WRITE_ENABLED=<WRAPS_WRITE_ENABLED> --env WRAPS_FROM_EMAIL=<WRAPS_FROM_EMAIL> --env WRAPS_ALLOWED_RECIPIENTS=<WRAPS_ALLOWED_RECIPIENTS> --transport stdio mcp -- npx -y @wraps.dev/mcpReplace <…> with your own values. 2 more environment variables are in the server README
Platform CLI
codex mcp add mcp --env AWS_REGION=<AWS_REGION> --env AWS_PROFILE=<AWS_PROFILE> --env WRAPS_WRITE_ENABLED=<WRAPS_WRITE_ENABLED> --env WRAPS_FROM_EMAIL=<WRAPS_FROM_EMAIL> --env WRAPS_ALLOWED_RECIPIENTS=<WRAPS_ALLOWED_RECIPIENTS> -- npx -y @wraps.dev/mcpReplace <…> with your own values. 2 more environment variables are in the server README
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@wraps.dev/mcp"
],
"env": {
"AWS_REGION": "<AWS_REGION>",
"AWS_PROFILE": "<AWS_PROFILE>",
"WRAPS_WRITE_ENABLED": "<WRAPS_WRITE_ENABLED>",
"WRAPS_FROM_EMAIL": "<WRAPS_FROM_EMAIL>",
"WRAPS_ALLOWED_RECIPIENTS": "<WRAPS_ALLOWED_RECIPIENTS>"
}
}
}
}Replace <…> with your own values. 2 more environment variables are in the server README
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wraps.dev/mcp"
],
"env": {
"AWS_REGION": "<AWS_REGION>",
"AWS_PROFILE": "<AWS_PROFILE>",
"WRAPS_WRITE_ENABLED": "<WRAPS_WRITE_ENABLED>",
"WRAPS_FROM_EMAIL": "<WRAPS_FROM_EMAIL>",
"WRAPS_ALLOWED_RECIPIENTS": "<WRAPS_ALLOWED_RECIPIENTS>"
}
}
}
}Replace <…> with your own values. 2 more environment variables are in the server README
Platform CLI
gemini mcp add -e AWS_REGION=<AWS_REGION> -e AWS_PROFILE=<AWS_PROFILE> -e WRAPS_WRITE_ENABLED=<WRAPS_WRITE_ENABLED> -e WRAPS_FROM_EMAIL=<WRAPS_FROM_EMAIL> -e WRAPS_ALLOWED_RECIPIENTS=<WRAPS_ALLOWED_RECIPIENTS> mcp npx -y @wraps.dev/mcpReplace <…> with your own values. 2 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about email
How do I install email in Claude Code?
Run claude mcp add email -- npx -y @wraps.dev/mcp.
What does email do?
This MCP server gives an agent access to Amazon SES for sending mail, checking domain and DKIM status, inspecting suppressions, and viewing sandbox state.
What is required before sending email?
Configure AWS credentials and an SES account in the target region. Set WRAPS_WRITE_ENABLED=true, and use a sender address from a domain verified in SES.
