How do I install Resend Email MCP?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Resend Email MCP need an API key?

The publisher lists these environment variables: RESEND_API_KEY, RESEND_FROM, RESEND_REPLY_TO, RESEND_READONLY, RESEND_ATTACHMENTS_DIR.

What transport does Resend Email MCP use?

Resend Email MCP runs locally over stdio.

When was Resend Email MCP last checked?

Last checked 2026-11-09. Complete Resend email MCP: full API coverage + debug layer (deliverability, DNS, bounces).

Resend Email MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

RESEND_API_KEY — Resend API key (https://resend.com/api-keys)
RESEND_FROM — Default sender address (verified domain), e.g. 'Acme <[email protected]>'
RESEND_REPLY_TO — Default Reply-To address
RESEND_READONLY — Set to 'true' to block every mutating tool
RESEND_ATTACHMENTS_DIR — Directory that local-file attachments are restricted to (disk reads disabled unless set)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1RESEND_API_KEY=<secret> RESEND_FROM=<value> RESEND_REPLY_TO=<value> RESEND_READONLY=<value> RESEND_ATTACHMENTS_DIR=<value> claude mcp add io.github.helbertparanhos-resend-email-mcp -- npx -y resend-email-mcp@1.0.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.helbertparanhos-resend-email-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "RESEND_API_KEY": "<secret>",11        "RESEND_FROM": "<value>",12        "RESEND_REPLY_TO": "<value>",13        "RESEND_READONLY": "<value>",14        "RESEND_ATTACHMENTS_DIR": "<value>"15      }16    }17  }18}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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)

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

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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Resend Email MCP?

Does Resend Email MCP need an API key?

What transport does Resend Email MCP use?

When was Resend Email MCP last checked?

Documentation

resend-email-mcp

Why this MCP

Quick start

1. Get a Resend API key

2. Add to your MCP client

Claude Code (CLI)

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

Configuration

Tools

Emails

Attachments (sent & received)

Domains

API keys

Broadcasts

Contacts

Contact properties

Segments

Templates

Topics

Webhooks

Logs

🔍 Debug & diagnostics (the differentiator)

Escape hatch

Resources

Example prompts

Testing safely

Troubleshooting

Local development

License

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