Mailgun MCP Server

What is Mailgun MCP Server about?

Enables AI‑driven applications, such as Claude Desktop, to interact with Mailgun services via the Model Context Protocol, allowing email sending and statistics retrieval through standard stdin/stdout communication.

How to use Mailgun MCP Server?

Clone the repository and install dependencies with Node.js (v18+).
Configure Claude Desktop (or any MCP‑compatible client) by adding a server entry that runs the Node script src/mailgun-mcp.js and supplies the MAILGUN_API_KEY environment variable.
Run the server—the MCP client launches the Node process, which listens on stdio.
Execute prompts in the AI client to send emails or request statistics; the server processes the request via Mailgun’s REST API and returns results.

Key Features

Direct email sending via Mailgun with custom sender, recipient, subject, and body.
Retrieval of delivery statistics for a specified period, formatted for easy visualization.
Simple stdio‑based communication compatible with any MCP client.
Minimal setup: only Node.js and a Mailgun API key are required.

Use Cases

Automating transactional email workflows from AI assistants.
Generating on‑the‑fly email reports and charts for weekly delivery performance.
Integrating email capabilities into custom AI agents without writing HTTP request code.
Rapid prototyping of email‑driven AI features in Claude Desktop or similar tools.

FAQ

Q: Do I need a paid Mailgun account? A: Sending emails via the MCP server works with any Mailgun account that has an API key, but some features (e.g., certain delivery statistics) may require a paid tier.

Q: Can I run the server locally for testing? A: Yes. Use NODE_ENV=test npm test to run the provided test suite, then start the server with node src/mailgun-mcp.js.

Q: What environment variable is required? A: Set MAILGUN_API_KEY to your Mailgun private API key before launching the server.

Q: Is the server compatible with other MCP clients? A: Any client that follows the Model Context Protocol over stdio can interact with this server.

Overview

A Model Context Protocol (MCP) server implementation for Mailgun, enabling MCP-compatible AI clients like Claude Desktop to interract with the service.

Prerequisites

Node.js (v18 or higher)
Git
Claude Desktop (for Claude integration)
Mailgun account and an API key

Quick Start

Manual Installation

Clone the repository:

git clone https://github.com/mailgun/mailgun-mcp-server.git
cd mailgun-mcp-server

Install dependencies and build:
```
npm install
```

Configure Claude Desktop:

Create or modify the config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the following configuration:

{
    "mcpServers": {
        "mailgun": {
            "command": "node",
            "args": ["CHANGE/THIS/PATH/TO/mailgun-mcp-server/src/mailgun-mcp.js"],
            "env": {
                "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
            }
        }
    }
}

Testing

Run the local test suite with:

NODE_ENV=test npm test

Sample Prompts with Claude

Send an Email

Note: sending an email currently (2025-03-18) seems to require a paid account with Anthropic. You'll get a silent failure on the free account

Can you send an email to EMAIL_HERE with a funny email body that makes it sound like it's from the IT Desk from Office Space?
Please use the sending domain DOMAIN_HERE, and make the email from "postmaster@DOMAIN_HERE"!

Fetch and Visualize Sending Statistics

Would you be able to make a chart with email delivery statistics for the past week?

Debugging

The MCP server communicates over stdio, please refer to Debugging section of the Model Context Protocol.

License

LICENSE file for details

Contributing

We welcome contributions! Please feel free to submit a Pull Request.

Mailgun MCP Server