What is Mailgun MCP Server?

An MCP server implementation for Mailgun that enables AI clients like Claude Desktop to interact with Mailgun's email API for sending messages and retrieving statistics.

How to use Mailgun MCP Server?

1. Clone the repository and install dependencies
2. Configure Claude Desktop with the server path and Mailgun API key
3. Use AI prompts to send emails or request analytics

Key features of Mailgun MCP Server?

• Integration with Mailgun's email API
• Model Context Protocol (MCP) server implementation
• Email sending capabilities with custom content
• Email statistics retrieval and visualization
• Compatibility with Claude Desktop AI client

Use cases of Mailgun MCP Server?

1. Automating email campaigns through AI prompts
2. Generating visual reports of email delivery metrics
3. Integrating email functionality with AI assistants

FAQ about Mailgun MCP Server?

• What prerequisites are required?

Node.js v18+, Git, Mailgun account/API key, and Claude Desktop for AI integration

• Why does email sending fail on free accounts?

Sending emails requires a paid Anthropic account as of 2025-03-18

• How to test the implementation?

Run the test suite with NODE_ENV=test npm test

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.