helbertparanhos/resend-email-mcp

**The most complete Resend MCP server** — full coverage of the Resend API (emails, domains, contacts, broadcasts, templates, segments, topics, webhooks, logs) **plus a unique debug/diagnostics layer** no other Resend MCP offers: deliverability analysis, DNS troubleshooting, email lifecycle inspection, bounce explanation, and account auditing.
Works with **Claude Code, Cursor, Claude Desktop**, and any other MCP client.
---
Why this MCP
| | resend-email-mcp | Official resend-mcp | Minimal MCPs |
|---|:---:|:---:|:---:|
| Send / batch / schedule | ✅ | ✅ | partial |
| Domains, contacts, broadcasts, templates, segments, topics, webhooks | ✅ | ✅ | ❌ |
| API request **logs** tools | ✅ | ❌ | ❌ |
| **Debug layer** (diagnose, analyze, inspect, explain, audit) | ✅ **7 tools** | ❌ | ❌ |
| Readonly safety mode | ✅ | ❌ | ❌ |
| Raw escape hatch for new endpoints | ✅ | ❌ | ❌ |
| Idempotency-key support | ✅ | partial | ❌ |
**75 tools + 2 resources.**
---
Quick start
1. Get a Resend API key
Create one at **https://resend.com/api-keys**.
2. Add to your MCP client
Claude Code (CLI)
Cursor / Claude Desktop / generic (mcp.json / claude_desktop_config.json)
Config file locations:
- **Claude Desktop (Windows):** %APPDATA%\Claude\claude_desktop_config.json
- **Claude Desktop (macOS):** ~/Library/Application Support/Claude/claude_desktop_config.json
- **Cursor:** ~/.cursor/mcp.json (or per-project .cursor/mcp.json)
Restart the client and ask: *"Send a test email to delivered@resend.dev"* or *"Audit my Resend account."*
---
Configuration
| Env var | Required | Description |
|---------|:---:|-------------|
| RESEND_API_KEY | ✅ | Your Resend API key |
| RESEND_FROM | – | Default sender for send_email when from is omitted (must be a verified domain) |
| RESEND_REPLY_TO | – | Default Reply-To address |
| RESEND_READONLY | – | true blocks every mutating tool (send/create/update/delete). Safe exploration of production |
| RESEND_ATTACHMENTS_DIR | – | Directory that send_email's localPath attachments are restricted to. **Unset = disk reads disabled** (safe default; path traversal is blocked) |
| RESEND_BASE_URL | – | Override API base URL (default https://api.resend.com). Must be https (http only for localhost) |
| RESEND_MAX_RETRIES | – | Retries on 429/5xx (default 3) |
---
Tools
Emails
send_email · send_batch_emails · get_email · list_emails · update_email · cancel_email · preview_email
> send_email accepts attachments by base64 content, public path (URL), or **localPath** (a file on disk, read and base64-encoded automatically — only enabled when RESEND_ATTACHMENTS_DIR is set, and restricted to that directory). preview_email dry-runs a message — resolving the final sender, sizing attachments, and surfacing warnings — **without sending**.
Attachments (sent & received)
list_email_attachments · get_email_attachment · list_received_emails · get_received_email · list_received_attachments · get_received_attachment
Domains
create_domain · get_domain · list_domains · update_domain · delete_domain · verify_domain
API keys
create_api_key · list_api_keys · delete_api_key
Broadcasts
create_broadcast · get_broadcast · list_broadcasts · update_broadcast · send_broadcast · delete_broadcast
Contacts
create_contact · get_contact · list_contacts · update_contact · delete_contact · get_contact_topics · update_contact_topics · list_contact_segments · add_contact_to_segment · remove_contact_from_segment
Contact properties
create_contact_property · get_contact_property · list_contact_properties · update_contact_property · delete_contact_property