Mailgun MCP

How to Install and Use Mailgun MCP

Mailgun MCP is a server that lets AI tools like Claude Desktop talk to the Mailgun email service using a special protocol called Model Context Protocol (MCP). This guide will show you how to install Mailgun MCP and run it step by step with useful examples.

What You Need Before Starting

Before we jump into the installation, make sure you have some important things ready. You need Node.js version 18 or higher installed on your computer. You will also need Git to download the Mailgun MCP software. If you want to use Claude Desktop with Mailgun MCP, you should have that installed too. Lastly, you must have a Mailgun account and an API key to connect the server to your email service.

Step 1: Download the Mailgun MCP Software

First, you need to get the Mailgun MCP code on your computer. Open a terminal or command prompt and type this command to copy the software:

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

This downloads the files and puts you inside the Mailgun MCP folder.

Step 2: Install Software Dependencies

Now that you have the code, you need to install the programs it depends on. In the same terminal, run this command:

npm install

This command downloads and sets up everything needed so Mailgun MCP can work correctly.

Step 3: Connect with Claude Desktop

To use Mailgun MCP with Claude Desktop, you have to add the server to Claude's settings. On your computer, find or create a config file named claude_desktop_config.json in these locations:

• On Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json

Open this file and add the following example configuration. Make sure to replace "CHANGE/THIS/PATH/TO/mailgun-mcp-server/src/mailgun-mcp.js" with the actual path to the Mailgun MCP script on your computer. Also, put your Mailgun API key where it says "YOUR-mailgun-api-key".

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

This setup tells Claude Desktop how to run Mailgun MCP and connect it to your Mailgun account.

Step 4: Test the Installation

You can check if everything is working by running the test suite for Mailgun MCP. In your terminal, type:

NODE_ENV=test npm test

This runs some automated tests to make sure Mailgun MCP is set up properly.

Using Mailgun MCP with Claude: Example Prompts

Once everything is installed, you can start sending commands to Mailgun MCP through Claude Desktop. Here are two simple examples:

Send an Email

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"!

Note: Sending email might require a paid account with Anthropic as of March 2025.

Fetch and Visualize Sending Statistics

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

These prompts allow you to interact with Mailgun through Claude’s AI using Mailgun MCP.

---

By following these steps, you will have Mailgun MCP installed and ready to use. This makes it easy to control your Mailgun email service with AI tools.