@skanda-yutori/mcp-send-email

v1.0.0

Published

6 months ago

MCP server for sending emails via Resend API

0High
0Medium
0Low

skanda-yutori

mcp email resend model-context-protocol

MCP Send Email Server

A Model Context Protocol (MCP) server for sending emails using the Resend API. This package can be used as an MCP server or as a standalone CLI tool.

Installation

As an npx package (recommended)

npx @your-username/mcp-send-email --key YOUR_RESEND_API_KEY

As a global package

npm install -g @your-username/mcp-send-email
mcp-send-email --key YOUR_RESEND_API_KEY

As a local dependency

npm install @your-username/mcp-send-email

Prerequisites

Resend API Key: Get your API key from Resend
Node.js: Version 18 or higher

Configuration

Environment Variables

You can configure the server using environment variables:

RESEND_API_KEY: Your Resend API key (required)
SENDER_EMAIL_ADDRESS: Default sender email address (optional)
REPLY_TO_EMAIL_ADDRESSES: Comma-separated list of reply-to email addresses (optional)

Command Line Arguments

--key: Resend API key
--sender: Default sender email address
--reply-to: Reply-to email address(es)

Usage

As an MCP Server

The server runs on stdio and can be integrated with MCP clients:

npx @your-username/mcp-send-email --key YOUR_API_KEY

MCP Configuration

Add this to your MCP client configuration:

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["@your-username/mcp-send-email", "--key", "YOUR_API_KEY"]
    }
  }
}

Available Tools

The server provides a send-email tool with the following parameters:

to (required): Recipient email address
subject (required): Email subject line
text (required): Plain text email content
html (optional): HTML email content
from (optional): Sender email address (if not configured globally)
replyTo (optional): Reply-to email addresses
cc (optional): CC email addresses
bcc (optional): BCC email addresses
scheduledAt (optional): Schedule email using natural language (e.g., "tomorrow at 10am")

Examples

Basic Email

// Using the MCP tool
await sendEmail({
  to: "[email protected]",
  subject: "Hello from MCP",
  text: "This is a test email sent via MCP server."
});

HTML Email with Scheduling

await sendEmail({
  to: "[email protected]",
  subject: "HTML Email",
  text: "Plain text fallback",
  html: "<h1>Hello!</h1><p>This is an HTML email.</p>",
  scheduledAt: "tomorrow at 9am PST"
});

Development

Building from Source

git clone https://github.com/your-username/mcp-send-email.git
cd mcp-send-email
npm install
npm run build

Running in Development

npm install
npm run build
node build/index.js --key YOUR_API_KEY

Publishing Updates

Update the version in package.json
Update CHANGELOG.md
Build the project: npm run build
Publish to npm: npm publish

License

MIT License - see LICENSE file for details.

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request

Support

Issues: GitHub Issues
Documentation: GitHub README

Email sending MCP 💌

This is a simple MCP server that sends emails using Resend's API. Why? Now you can let Cursor or Claude Desktop compose emails for you and send it right away without having to copy and paste the email content.

As an example, you could use this to run local scripts, chat with Claude, or process data and send the results to yourself or your team.

Built with:

Features

Send plain text and HTML emails
Schedule emails for future delivery
Add CC and BCC recipients
Configure reply-to addresses
Customizable sender email (requires verification)

Demo

https://github.com/user-attachments/assets/8c05cbf0-1664-4b3b-afb1-663b46af3464

Setup

Currently, you must build the project locally to use this MCP server. Then add the server in Cursor or Claude Desktop to use it in any Cursor or Claude Desktop chat.

Clone this project locally.

git clone https://github.com/resend/mcp-send-email.git

Build the project

npm install
npm run build

Setup Resend

Create a free Resend account and Create an API Key. To send to other addresses, you'll also need to verify your own domain.

[!NOTE] For more info on how to send emails with Resend, see the docs.

Cursor

Open Cursor Settings.

Open the command palette (cmd+shift+p on macOS or ctrl+shift+p on Windows) and choose "Cursor Settings".

Add the MCP server

Select "MCP" from the left sidebar and click "Add new global MCP server".

Add the following config:

{
  "mcpServers": {
    "resend": {
      "type": "command",
      "command": "node ABSOLUTE_PATH_TO_MCP_SEND_EMAIL_PROJECT/build/index.js --key=YOUR_RESEND_API_KEY"
    }
  }
}

You can get the absolute path to your build script by right-clicking on the /build/index.js file in Cursor and selecting Copy Path.

Possible arguments

--key: Your Resend API key (required)
--sender: Your sender email address from a verified domain (optional)
--reply-to: Your reply-to email address (optional)

[!NOTE] If you don't provide a sender email address, the MCP server will ask you to provide one each time you call the tool.

Test the sending

Now you can test out sending emails by going to email.md.

Replace the to: email address with your own
Select all text in email.md, and press cmd+l
Tell cursor to "send this as an email" in the chat (make sure cursor is in Agent mode by selecting "Agent" on lower left side dropdown).

Claude Desktop

Open Claude's Developer config file

Open Claude Desktop settings and navigate to the "Developer" tab. Click Edit Config.

Add the MCP server