What is Mailgun MCP Server

The Mailgun MCP Server is an implementation of the Model Context Protocol designed for integration with Mailgun, enabling AI clients like Claude Desktop to interact seamlessly with the email service.

Use cases

This server can be used to send emails with custom content, fetch email delivery statistics, and visualize data trends over specified periods, making it useful for businesses that require efficient email communication and analytics.

How to use

To use the server, clone the repository, install required dependencies, and configure Claude Desktop with the path to the MCP server script and the Mailgun API key in the configuration file. You can then issue prompts through Claude to interact with Mailgun’s services.

Key features

Key features include the ability to send formatted emails, retrieve delivery statistics, and generate visual data representations. It also supports configuration flexibility for different operating systems.

Where to use

This MCP server is ideal for environments where email automation and data analysis are critical, such as in digital marketing, customer support, and internal communications for organizations leveraging Mailgun’s email capabilities.

Mailgun MCP 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

1. Clone the repository:

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

2. Install dependencies and build:

   npm install
   

3. 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.