resend-mcp

MCP server for the Resend email API. Exposes 49 tools for sending emails, managing domains, contacts, templates, broadcasts, webhooks, and more.

Installation

From Source

cargo install --path .

Docker

docker pull ghcr.io/psu3d0/resend-mcp:latest
docker run -p 8080:8080 ghcr.io/psu3d0/resend-mcp:latest

Pre-built Binaries

Download from GitHub Releases.

Usage

# Start server (default: http://127.0.0.1:8080/mcp)
resend-mcp

# Custom bind address
BIND_ADDRESS=0.0.0.0 PORT=3000 resend-mcp

# Debug logging
RESEND_MCP_LOG=debug resend-mcp

MCP Client Configuration

Claude Desktop

{
  "mcpServers": {
    "resend": {
      "command": "resend-mcp",
      "env": {
        "BIND_ADDRESS": "127.0.0.1",
        "PORT": "8080"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "resend": {
      "command": "docker",
      "args": ["run", "--rm", "-p", "8080:8080", "ghcr.io/psu3d0/resend-mcp:latest"]
    }
  }
}

Available Tools

Emails

• sendEmail - Send an email
• sendBatchEmails - Send up to 100 emails at once
• getEmail - Retrieve a single email
• updateEmail - Update a scheduled email
• cancelScheduledEmail - Cancel a scheduled email
• listEmailAttachments - List attachments for a sent email
• getEmailAttachment - Get a single attachment

Received Emails

• listReceivedEmails - List received emails
• getReceivedEmail - Get a single received email
• listReceivedEmailAttachments - List attachments for a received email
• getReceivedEmailAttachment - Get a received email attachment

Domains

• createDomain - Create a new domain
• listDomains - List all domains
• getDomain - Get a single domain
• updateDomain - Update a domain
• deleteDomain - Delete a domain
• verifyDomain - Verify a domain

API Keys

• createApiKey - Create a new API key
• listApiKeys - List all API keys
• deleteApiKey - Delete an API key

Audiences

• createAudience - Create an audience
• listAudiences - List all audiences
• getAudience - Get a single audience
• deleteAudience - Delete an audience

Contacts

• createContact - Create a contact
• listContacts - List contacts in an audience
• getContactByEmail / getContactById - Get a contact
• updateContactByEmail / updateContactById - Update a contact
• deleteContactByEmail / deleteContactById - Delete a contact

Broadcasts

• createBroadcast - Create a broadcast
• listBroadcasts - List all broadcasts
• getBroadcast - Get a single broadcast
• deleteBroadcast - Delete a draft broadcast
• sendBroadcast - Send or schedule a broadcast

Templates

• createTemplate - Create a template
• listTemplates - List all templates
• getTemplate - Get a single template
• updateTemplate - Update a template
• deleteTemplate - Delete a template
• duplicateTemplate - Duplicate a template
• publishTemplate - Publish a template

Webhooks

• createWebhook - Create a webhook
• listWebhooks - List all webhooks
• getWebhook - Get a single webhook
• updateWebhook - Update a webhook
• deleteWebhook - Delete a webhook

Environment Variables

Authentication

The Resend API requires a Bearer token. Pass it via the MCP client's authorization header - the server forwards it to the Resend API.

Development

# Build
cargo build

# Run with debug logging
RESEND_MCP_LOG=debug cargo run

# Format and lint
cargo fmt && cargo clippy

# Update OpenAPI spec from upstream
python scripts/transform_spec.py /path/to/upstream/resend.yaml src/specs/resend.yaml

OpenAPI Spec Updates

The spec is automatically synced from resend/resend-openapi daily via GitHub Actions. The transform script adds operationId fields and fixes YAML parsing issues.

License

Apache-2.0