Resend MCP Server
This server gives AI assistants full access to the Resend transactional email API through natural language, covering email sending, domain management, API key management, and contact/audience management.
Email Sending
Send a single transactional email with HTML or plain text, Cc/Bcc, Reply-To, custom headers, and scheduled delivery
Send batch emails (up to 100 in a single API call)
List recent sent emails and their delivery status
Get full details of a specific email by ID
Domain Management
Create, list, verify DNS records for, and delete sending domains
API Key Management
Create API keys with full, sending, or domain-scoped permissions
List active API keys (tokens hidden) and delete them by ID
Audience & Contact Management
Create and list audiences for organizing contacts
Full CRUD operations on contacts within audiences, including managing subscription status
Additional Capabilities
Automate email workflows (e.g., sending welcome emails, auditing infrastructure) via conversational prompts
Built-in rate-limiting and automatic retry on 429 errors to stay within Resend's API limits
Compatible with any MCP client such as Claude Desktop, Cursor, or Windsurf
Allows sending transactional emails, managing sending domains, API keys, and audience contacts via the Resend API.
Resend MCP Server
An MCP server for Resend — connect any MCP-compatible client to the Resend transactional email API.
What is this?
An MCP (Model Context Protocol) server that gives AI assistants and agents full access to Resend's email API — send single or batch emails, manage sending domains, API keys, audiences, and contacts — through natural language.
Use it with Claude Desktop, Cursor, Windsurf, Cline, Continue, or any MCP-compatible client to send emails, manage infrastructure, and build automation around email.
Related MCP server: Resend MCP
Why use this?
18 built-in tools — covers sending (single + batch), domains, API keys, audiences, and contacts
Send emails by talking — "send a welcome email to jane@example.com" just works
Manage your infrastructure — create/verify/delete domains, mint/revoke API keys, manage contacts
Batch sending — send up to 100 emails in a single API call
Full contact CRUD — create, read, update, and delete contacts across audiences
Rate-limited automatically — respects Resend's 10 req/s free tier, retries on 429
Works with every MCP client — Claude Desktop, Cursor, Windsurf, Cline, Continue, and more
Quick Start
Add to your MCP client config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp-server"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxxxxx"
}
}
}
}Get a free API key at resend.com/api-keys.
Use it
Ask your AI assistant things like:
"Send an email to jane@example.com thanking her for signing up"
"List the last 5 emails I sent"
"What happened to email ID
abc-123?""Create a new sending domain for
mail.acme.com""Verify domain
domain-xyz""Mint a new API key called 'production-server'"
"Add jane@example.com to audience
audience-1"
Tools
Tool | Description |
| Send a transactional email (HTML or plain text, with Cc/Bcc/Reply-To) |
| Send up to 100 emails in a single API call |
| List recent sent emails with their delivery status |
| Get details for a specific email by ID |
| Add a new sending domain |
| List all sending domains in your account |
| Trigger DNS verification for a domain |
| Remove a sending domain |
| Create a new API key (full, sending, or domain-scoped) |
| List all API keys (tokens are hidden) |
| Delete an API key by ID |
| List all audiences in your account |
| Create a new audience for organizing contacts |
| List contacts in an audience |
| Get details for a specific contact by ID |
| Add a new contact to an audience |
| Update a contact's email, name, or subscription status |
| Remove a contact from an audience |
Use Cases
Transactional Email Automation
"Send a welcome email to every new signup" — automate onboarding flows, receipts, and notifications through natural language. No more switching between email dashboards.
Domain Management
"Add mail.acme.com as a sending domain and verify it" — manage DNS records, DKIM, and SPF through your AI assistant instead of logging into Resend's dashboard.
Contact & Audience Management
"Add jane@example.com to my VIP audience" — build and segment contact lists without touching a spreadsheet. Full CRUD on contacts and audiences.
Batch Campaigns
"Send this newsletter to all contacts in audience-1" — batch-send up to 100 emails in one call. Perfect for newsletters, product announcements, or re-engagement campaigns.
Infrastructure Audit
"List all my API keys and domains" — audit your Resend setup in seconds. See which keys are active, which domains are verified, and clean up stale resources.
Security
API key required — Resend API key is passed via environment variable, never logged or stored in files.
No local file access — does not read or write any files on your machine.
No shell access — does not execute commands or spawn processes.
Rate-limited — automatically caps requests at ~9 req/s to stay within Resend's free tier.
Open source — MIT licensed. Inspect the code at GitHub.
Troubleshooting
Rate limit errors (429)
The server auto-retries on 429 with a 2s backoff. Free tier allows 10 req/s. The server caps at ~9 req/s to stay safe. If you hit this frequently, consider upgrading your Resend plan.
"Invalid API key" errors
Verify your RESEND_API_KEY starts with re_ and is active at resend.com/api-keys. Keys take up to 30 seconds to propagate after creation.
Server won't start
Make sure Node.js 18+ is installed: node --version. If using npx, ensure npm is up to date: npm install -g npm@latest.
MCP client can't connect
Verify the config path is correct. Claude Desktop uses ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\Claude\claude_desktop_config.json on Windows. Restart the client after config changes.
Emails not delivering
Check list_emails for delivery status. Common issues: missing DNS records (run verify_domain), bounce due to invalid address, or domain not yet verified. Resend's dashboard shows detailed webhook events.
Requirements
Node.js 18+
A Resend account and API key (
RESEND_API_KEY)
Rate Limits
The server automatically rate-limits requests to ~9 calls/second to stay safely under Resend's free-tier limit of 10 req/s. If you hit a 429 anyway, it waits 2s and retries once.
Development
git clone https://github.com/friendlygeorge/resend-mcp-server.git
cd resend-mcp-server
npm install
npm run build
RESEND_API_KEY=re_xxxx npm startLicense
MIT
Available Tools
18 toolscreate_api_keyA
Create a new Resend API key (token is only returned once)
Inputs: name (required), permission, domain_id.
create_audienceB
Create a new audience for organizing contacts
Inputs: name (required).
create_contactB
Add a new contact to a Resend audience
Inputs: audience_id (required), email (required), first_name, last_name, +1 more.
create_domainB
Create a new sending domain in Resend
Inputs: name (required), region.
delete_api_keyB
Delete a Resend API key by ID
Inputs: key_id (required).
delete_contactC
Remove a contact from an audience
Inputs: audience_id (required), contact_id (required).
delete_domainB
Remove a sending domain from your Resend account
Inputs: domain_id (required).
get_contactB
Get details about a specific contact by ID
Inputs: audience_id (required), contact_id (required).
get_emailB
Get details about a specific email by ID
Inputs: email_id (required).
list_api_keysA
List all API keys in your Resend account (tokens are hidden)
Inputs: no named parameters.
list_audiencesB
List all audiences in your Resend account
Inputs: limit.
list_contactsB
List contacts in a Resend audience
Inputs: audience_id (required), limit.
list_domainsA
List all sending domains in your Resend account
Inputs: limit.
list_emailsC
List recent emails sent via Resend
Inputs: limit.
send_batch_emailA
Send multiple transactional emails in a single API call (up to 100)
Inputs: emails (required).
send_emailB
Send a transactional email via Resend
Inputs: from (required), to (required), subject (required), html, +6 more.
update_contactC
Update an existing contact's properties
Inputs: audience_id (required), contact_id (required), email, first_name, +2 more.
verify_domainB
Trigger verification of a domain's DNS records
Inputs: domain_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Each tool targets a distinct resource and action. Send_email vs send_batch_email are clearly differentiated by batch vs single. CRUD operations for each resource are separate and unambiguous.
All tool names follow a consistent verb_noun pattern using lowercase snake_case (e.g., create_api_key, list_domains). No mixing of styles or inconsistent verbs.
18 tools cover the main resources of an email service (API keys, audiences, contacts, domains, emails) without being excessive. Each tool serves a clear purpose.
The tool surface provides full CRUD for API keys (create, list, delete), domains (create, list, delete, verify), audiences (create, list), contacts (create, list, get, update, delete), and emails (send, send_batch, get, list). No obvious gaps for typical email API operations.
Maintenance
Related MCP Connectors
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Hosted email for AI agents: create inboxes, send, receive, and reply over MCP with scoped API keys
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP (Multi-Agent Conversation Protocol) Server for interacting with Resend's email API, auto-generated using AG2's MCP builder to enable sending emails through natural language.-
- AlicenseNot gradedqualityDmaintenanceEnables sending emails through the Resend service API. Provides a simple email sending tool that integrates with MCP-compatible clients.MIT
- AlicenseAqualityCmaintenanceAn MCP server for the PostStack email API that enables AI assistants to send transactional emails, manage contacts, handle inbound email threads, and perform deliverability checks through 84 curated tools.8418 npm1MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to send emails via SMTP, supporting simple and custom emails with attachments and CC/BCC, plus connection testing.328MIT