Install Now
mailgun-mcp-server
Interact with Mailgun's email services by sending emails, retrieving statistics, and visualizing email data. Provides seamless integration with AI clients for enhanced email capabilities.
Author
mailgun
Quick Info
GitHub Stars 34
Weekly Downloads 0Actions
Tags
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
-
Clone the repository:
bash git clone https://github.com/mailgun/mailgun-mcp-server.git cd mailgun-mcp-server -
Install dependencies and build:
bash 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:
json
{
"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.
PNG Icons
