# SendLayer MCP Server
This MCP server exposes tools for sending email and managing SendLayer webhooks/events using the SendLayer Node.js SDK.
## Tools
- **send-email**: Send a message (plain text or HTML), with CC/BCC, reply-to, tags, headers, and attachments.
- **get-events**: Query events with optional filters.
- **list-webhooks**: List registered webhooks.
- **create-webhook**: Create a webhook.
- **delete-webhook**: Delete a webhook by ID.
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:
- [SendLayer](https://sendlayer.com/)
- [Anthropic MCP](https://docs.anthropic.com/en/docs/agents-and-tools/mcp)
- [Cursor](https://cursor.so/)
## Features
- Send plain text and HTML emails
- Send emails with attachment
- Add CC and BCC recipients
- Customizable sender email (requires verification)
- Creating and managing webhooks
- Viewing email events
## Demo
Add video demo
## Setup
### Option 1: Use the Remote Server (Recommended)
The easiest way to get started is to use the hosted SendLayer MCP server. No local installation required!
#### Prerequisites
- A SendLayer account and API key ([Get your API key](https://app.sendlayer.com/))
- Cursor or Claude Desktop
#### Connecting to the Remote Server
##### Cursor
1. Open Cursor Settings.
Open the command palette (`cmd`+`shift`+`p` on macOS or `ctrl`+`shift`+`p` on Windows) and choose "Cursor Settings".
2. Add the MCP server
Select **Tools & MCP** from the left sidebar and click **New MCP server**.
3. Configure the remote server
Add the following config:
```json
{
"mcpServers": {
"sendlayer": {
"type": "url",
"url": "https://sendlayer.com/mcp",
"headers": {
"x-sendlayer-api-key": "YOUR_SENDLAYER_API_KEY"
}
}
}
}
```
Replace `YOUR_SENDLAYER_API_KEY` with your actual SendLayer API key from [app.sendlayer.com](https://app.sendlayer.com/).
4. Test the connection
Restart Cursor and verify the MCP server is connected. You can now use commands like "send an email to recipient@example.com" in Agent mode.
##### Claude Desktop
1. Open Claude's Developer config file
Open Claude Desktop settings and navigate to the **Developer** tab. Click **Edit Config** and open the file in a code editor.
2. Add the MCP server
Add the following config:
```json
{
"mcpServers": {
"sendlayer-deployed": {
"url": "https://sendlayer.com/mcp",
"headers": {
"x-sendlayer-api-key": "YOUR_SENDLAYER_API_KEY"
}
}
}
}
```
Replace `YOUR_SENDLAYER_API_KEY` with your actual SendLayer API key.
3. Test the connection
Restart Claude Desktop and verify that the `sendlayer-mcp` tools are available. You can now ask Claude to send emails using the SendLayer MCP tools.
### Option 2: Local Setup
If you prefer to run the MCP server locally, follow these steps:
1. Clone this project locally.
```
git clone https://github.com/sendlayer/mcp-send-email.git
```
2. Build the project
```
npm install
npm run build
```
3. Setup SendLayer
Create a free SendLayer account and [Create an API Key](https://sendlayer.com/docs/managing-api-keys/). Before sending emails, you'll also need to [verify your sending domain](https://sendlayer.com/docs/authorizing-your-domain/).
#### Connecting the Local MCP Server
##### Cursor
1. Open Cursor Settings.
Open the command palette (`cmd`+`shift`+`p` on macOS or `ctrl`+`shift`+`p` on Windows) and choose "Cursor Settings".
2. Add the MCP server
Select **Tools & MCP** from the left sidebar and click **New MCP server**.
Add the following config:
```json
{
"mcpServers": {
"sendlayer": {
"type": "command",
"command": "node",
"args": [
"ABSOLUTE_PATH_TO_SENDLAYER_MCP_PROJECT/build/index.js",
"--key=YOUR_SENDLAYER_API_KEY"
]
}
}
}
```
You can get the absolute path to your build script by right-clicking on the `/build/index.js` file in your code editor and selecting `Copy Path`.
**Supported Arguments**
- `--key`: Your SendLayer API key (required)
- `--sender`: Your sender email address from a verified domain (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.
3. Test the sending
Now you can test out sending emails using the command `send an email to recipient@example.com`.
- You can specify the subject and email content or let the AI model generate one for you.
- 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
1. Open Claude's Developer config file
Open Claude Desktop settings and navigate to the **Developer** tab. Click **Edit Config** and open the file in a code editor.
2. Add the MCP server
Add the following config:
```json
{
"mcpServers": {
"sendlayer": {
"command": "node",
"args": [
"ABSOLUTE_PATH_TO_SENDLAYER_MCP_PROJECT/build/index.js"
],
"env": {
"SENDLAYER_API_KEY": "YOUR_SENDLAYER_API_KEY"
}
}
}
}
```
> **Note:** You can get the absolute path to your build script by right-clicking on the `/build/index.js` file in your IDE and selecting **Copy Path**.
**Possible environment variables**
- `SENDLAYER_API_KEY`: Your SendLayer API key (required)
- `SENDER_EMAIL_ADDRESS`: Your sender email address from a verified domain (optional)
If you don't provide a sender email address, the MCP server will ask you to provide one each time you call the tool.
3. Test the sending
Restart Claude Desktop. Verify that the `sendlayer-mcp` tool is available in the Claude developer settings.
Chat with Claude and tell it to send you an email using the `sendlayer-mcp` tool.
