Resend MCP Server
A complete Model Context Protocol (MCP) server for the Resend API, providing access to all Resend endpoints through Claude Desktop or any MCP-compatible client.
Features
This MCP server implements all Resend API endpoints:
Email Operations
- Send Email - Send single emails with attachments, scheduling, and custom headers
- Send Batch Emails - Send up to 100 emails in a single request
- Get Email - Retrieve email details and status
- Update Email - Modify scheduled emails
- Cancel Email - Cancel scheduled emails
Domain Management
- Create Domain - Add new sending domains
- List Domains - View all configured domains
- Get Domain - Retrieve domain details and DNS records
- Update Domain - Configure tracking and TLS settings
- Delete Domain - Remove domains
- Verify Domain - Trigger domain verification
API Key Management
- Create API Key - Generate new API keys with permissions
- List API Keys - View all API keys
- Delete API Key - Revoke API keys
Contact & Audience Management
- Create Audience - Create contact lists
- List Audiences - View all audiences
- Get/Delete Audience - Manage specific audiences
- Create Contact - Add contacts to audiences
- List Contacts - View audience contacts
- Get/Update/Delete Contact - Manage individual contacts
Broadcast Campaigns
- Create Broadcast - Design email campaigns
- List Broadcasts - View all broadcasts
- Get Broadcast - Retrieve broadcast details
- Update Broadcast - Update broadcast content and settings
- Send Broadcast - Send or schedule broadcasts
- Delete Broadcast - Remove draft broadcasts
Installation
Quick Install via NPX (Recommended)
You can run the Resend MCP server directly without installation:
npx resend-mcp-server --key YOUR_RESEND_API_KEY
Global Installation via NPM
npm install -g resend-mcp-server
Then run:
resend-mcp-server --key YOUR_RESEND_API_KEY
Local Installation
- Clone the repository:
git clone https://github.com/199-biotechnologies/mcp-send-email.git
cd mcp-send-email
- Install dependencies:
npm install
- Build the project:
npm run build
Configuration
Claude Desktop Setup
Add the following to your Claude Desktop configuration file:
Using NPX (Recommended):
{
"mcpServers": {
"resend": {
"command": "npx",
"args": [
"resend-mcp-server",
"--key",
"YOUR_RESEND_API_KEY"
]
}
}
}
Using Global Installation:
{
"mcpServers": {
"resend": {
"command": "resend-mcp-server",
"args": [
"--key",
"YOUR_RESEND_API_KEY"
]
}
}
}
Using Local Installation:
{
"mcpServers": {
"resend": {
"command": "node",
"args": [
"/path/to/mcp-send-email/build/index.js",
"--key",
"YOUR_RESEND_API_KEY"
]
}
}
}
Configuration Options
The server accepts the following command-line arguments:
--key- Your Resend API key (required)--sender- Default sender email address (optional)--reply-to- Default reply-to email addresses (optional, comma-separated)
You can also use environment variables:
RESEND_API_KEY- Your Resend API keySENDER_EMAIL_ADDRESS- Default sender emailREPLY_TO_EMAIL_ADDRESSES- Default reply-to addresses (comma-separated)
Finding Your Configuration File
The Claude Desktop configuration file location varies by platform:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/claude/claude_desktop_config.json
Usage Examples
Once configured, you can use natural language to interact with the Resend API through Claude:
Sending Emails
- "Send an email to [email protected] with subject 'Hello' and body 'Test message'"
- "Send a batch of emails to multiple recipients"
- "Schedule an email for tomorrow at 10am"
Managing Domains
- "List all my Resend domains"
- "Add example.com as a new sending domain"
- "Enable click tracking for my domain"
Contact Management
- "Create a new audience called 'Newsletter Subscribers'"
- "Add [email protected] to my newsletter audience"
- "List all contacts in my audience"
API Key Management
- "Create a new API key with sending access only"
- "List all my API keys"
Security Notes
- Never commit your API key to version control
- Use environment variables or secure credential management for production
- The server only exposes functionality through the MCP protocol
- All API operations require valid authentication
Development
Building from Source
# Install dependencies
npm install
# Build TypeScript
npm run build
# Run locally
node build/index.js --key YOUR_API_KEY
Testing
You can test the server using the MCP inspector or by configuring it in Claude Desktop.
Troubleshooting
Common Issues
-
"No API key provided" error
- Ensure you've set the
--keyargument orRESEND_API_KEYenvironment variable
- Ensure you've set the
-
Permission errors with NPX
- Try clearing the NPX cache:
npx clear-npx-cache - Or install globally:
npm install -g resend-mcp-server
- Try clearing the NPX cache:
-
Server not appearing in Claude
- Check your configuration file syntax
- Restart Claude Desktop after configuration changes
- Verify the path to the executable is correct
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT License - see LICENSE file for details
Support
For issues and feature requests, please use the GitHub issue tracker.
Acknowledgments
Built with:
