# email

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: wraps-team
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wraps-team/wraps-js/tree/HEAD/packages/mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/email

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `AWS_REGION`, `AWS_PROFILE`, `WRAPS_WRITE_ENABLED`, `WRAPS_FROM_EMAIL`, `WRAPS_ALLOWED_RECIPIENTS`, `WRAPS_ALLOWED_RECIPIENT_DOMAINS`, `WRAPS_HISTORY_TABLE_NAME` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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/mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
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/mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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/mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- 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
- 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.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md