by mailgun
Provides a Model Context Protocol server that enables AI clients to send emails and retrieve delivery statistics through the Mailgun API.
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.
src/mailgun-mcp.js and supplies the MAILGUN_API_KEY environment variable.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.
A Model Context Protocol (MCP) server implementation for Mailgun, enabling MCP-compatible AI clients like Claude Desktop to interract with the service.
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:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%/Claude/claude_desktop_config.jsonAdd 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"
}
}
}
}
Run the local test suite with:
NODE_ENV=test npm test
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"!
Would you be able to make a chart with email delivery statistics for the past week?
The MCP server communicates over stdio, please refer to Debugging section of the Model Context Protocol.
LICENSE file for details
We welcome contributions! Please feel free to submit a Pull Request.
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by zed-industries
A high‑performance, multiplayer code editor designed for speed and collaboration.
by modelcontextprotocol
Model Context Protocol Servers
by modelcontextprotocol
A Model Context Protocol server for Git repository interaction and automation.
by modelcontextprotocol
A Model Context Protocol server that provides time and timezone conversion capabilities.
by cline
An autonomous coding assistant that can create and edit files, execute terminal commands, and interact with a browser directly from your IDE, operating step‑by‑step with explicit user permission.
by continuedev
Enables faster shipping of code by integrating continuous AI agents across IDEs, terminals, and CI pipelines, offering chat, edit, autocomplete, and customizable agent workflows.
by upstash
Provides up-to-date, version‑specific library documentation and code examples directly inside LLM prompts, eliminating outdated information and hallucinated APIs.
by github
Connects AI tools directly to GitHub, enabling natural‑language interactions for repository browsing, issue and pull‑request management, CI/CD monitoring, code‑security analysis, and team collaboration.
by daytonaio
Provides a secure, elastic infrastructure that creates isolated sandboxes for running AI‑generated code with sub‑90 ms startup, unlimited persistence, and OCI/Docker compatibility.