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.

npm version License: MIT GitHub Stars GitHub Forks GitHub Issues Glama Quality

TypeScript Node.js MCP Claude Code Cursor Claude Desktop

Instagram YouTube LinkedIn Buy Me A Coffee Strat Academy

---

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)

claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxx -- npx -y resend-email-mcp

Cursor / Claude Desktop / generic (mcp.json / claude_desktop_config.json)

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-email-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxx",
        "RESEND_FROM": "Acme <[email protected]>"
      }
    }
  }
}

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 [email protected]" 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

Segments

create_segment · get_segment · list_segments · delete_segment · list_segment_contacts

Templates

create_template · get_template · list_templates · update_template · delete_template · publish_template · duplicate_template

Topics

create_topic · get_topic · list_topics · update_topic · delete_topic

Webhooks

create_webhook · get_webhook · list_webhooks · update_webhook · delete_webhook

Logs

list_logs · get_log

🔍 Debug & diagnostics (the differentiator)

Tool	What it does
diagnose_domain	Inspects every DNS record (SPF/DKIM/DMARC) and reports what's missing + how to fix it
analyze_deliverability	Aggregates recent sends into delivery/bounce/complaint rates with a health verdict
inspect_email	Renders one email's full lifecycle timeline and flags problems
explain_bounce	Classifies a bounce (hard/soft/block) and recommends the action
audit_account	One-shot health check of domains, keys, and deliverability
search_logs	Smart filtering of API logs by status/path/recipient to find failures
test_send	Safely simulates delivered/bounced/complained via Resend sandbox addresses

Escape hatch

resend_raw — call any Resend endpoint not yet wrapped in a dedicated tool.

Resources

Beyond tools, the server exposes two read-only MCP resources so a client can pull account context without spending a tool call:

URI	Content
resend://account	Domains + API keys snapshot
resend://domains	All sending domains with verification status

Every tool is annotated with MCP hints (readOnlyHint, destructiveHint, idempotentHint) so clients can show which operations are safe and which need confirmation.

---

Example prompts

• "Diagnose why acme.com isn't verified." → diagnose_domain
• "How healthy is my email sending this week?" → analyze_deliverability
• "What happened to email re_abc123?" → inspect_email
• "Why did that email bounce and what should I do?" → explain_bounce
• "Something's wrong with my Resend setup — check everything." → audit_account
• "Send our launch newsletter to the 'beta' segment." → create_broadcast + send_broadcast

---

Testing safely

Use Resend's sandbox addresses (no reputation impact):

• [email protected] — simulates delivery
• [email protected] — simulates a hard bounce
• [email protected] — simulates a spam complaint

Or just run test_send and then inspect_email on the returned ID.

Enable RESEND_READONLY=true to explore a production account without any risk of sending or deleting.

---

Troubleshooting

This MCP is built to debug itself — when something fails, reach for the diagnostic tools instead of guessing.

Symptom / error	Likely cause	What to run
validation_error: from domain is not verified	Your from/RESEND_FROM domain isn't verified	list_domains → diagnose_domain (shows missing DNS records + fixes) → verify_domain
Emails send but never arrive	Deliverability / reputation issue	analyze_deliverability then inspect_email on a sample ID
missing_api_key / invalid_api_key (HTTP 401)	RESEND_API_KEY unset or wrong	Check the .env; create a key at resend.com/api-keys
restricted_api_key / not_authorized (403)	Key scoped to sending-only or one domain	Use a full_access key (list_api_keys to inspect)
rate_limit_exceeded (429)	Too many requests	The client auto-retries with backoff; reduce volume
daily_quota_exceeded	Plan send limit reached	Upgrade plan or wait for reset
A specific email bounced	Invalid/blocking recipient	explain_bounce (classifies hard/soft/block + action)
"Is anything wrong with my setup?"	—	audit_account (one-shot health check)
Request fails for unknown reason	—	search_logs with only_errors: true

Every error returned by this server includes the HTTP status, Resend's error name, and an actionable Hint line.

---

Local development

git clone https://github.com/helbertparanhos/resend-email-mcp.git
cd resend-email-mcp
npm install
npm run build
cp .env.example .env   # add your RESEND_API_KEY
npm run inspector      # opens the MCP Inspector against the built server

---

License

MIT © Helbert Paranhos / Strat Academy

Built with the Model Context Protocol. Not affiliated with Resend.