Migadu MCP Server
Control your Migadu email hosting through AI assistants using the Model Context Protocol (MCP).
What is Migadu?
Migadu is a Swiss email hosting service that offers unlimited email addresses with pricing based on actual usage rather than mailbox count. They focus on standard email protocols (SMTP/IMAP/POP3) without vendor lock-in, making them popular with developers and privacy-conscious users.
What This Does
This MCP server lets AI assistants manage your Migadu email accounts. Instead of clicking through web interfaces, you can ask your AI to:
- Create and delete mailboxes
- Set up email aliases and forwarding rules
- Configure autoresponders
- Manage multiple email identities
- Handle bulk operations efficiently
Setup
Add to your MCP client configuration (e.g., Claude Desktop):
{
"mcpServers": {
"migadu": {
"command": "uvx",
"args": ["migadu-mcp"],
"env": {
"MIGADU_EMAIL": "admin@yourdomain.com",
"MIGADU_API_KEY": "your-api-key",
"MIGADU_DOMAIN": "yourdomain.com"
}
}
}
}
Get your API key from Migadu Admin > My Account > API Keys.
Example Usage
Once configured, you can ask your AI assistant things like:
- "Create a new mailbox for john@mydomain.com with the name John Smith"
- "List all mailboxes on my domain"
- "Set up an email alias support@mydomain.com that forwards to team@mydomain.com"
- "Delete the mailboxes for employees who left: alice@mydomain.com, bob@mydomain.com"
- "Create an autoresponder for vacation@mydomain.com"
Available Tools
Mailbox Management
list_mailboxes/list_my_mailboxes- View all mailboxesget_mailbox/get_my_mailbox- Get mailbox detailscreate_mailbox/create_my_mailbox- Create new mailboxesupdate_mailbox- Change mailbox settingsdelete_mailbox- Remove mailboxesbulk_delete_mailboxes- Delete multiple mailboxes at oncereset_mailbox_password- Change passwordsset_autoresponder- Configure out-of-office messages
Email Routing
list_aliases/list_my_aliases- View email aliasescreate_alias- Set up email forwarding without creating a mailboxupdate_alias- Change alias destinationsdelete_alias- Remove aliases
Identity Management
list_identities- View send-as addressescreate_identity- Add additional sending addressesupdate_identity- Modify identity permissionsdelete_identity- Remove identities
Advanced Routing
list_rewrites- View pattern-based routing rulescreate_rewrite- Set up wildcard email routingupdate_rewrite- Modify routing patternsdelete_rewrite- Remove routing rules
External Forwarding
list_forwardings- View external forwarding rulescreate_forwarding- Forward emails to external addressesupdate_forwarding- Change forwarding settingsdelete_forwarding- Remove forwarding rules
MCP Resources
Access structured data through these resource URIs:
mailboxes://domain.com- All mailboxes for a domainmailbox://domain.com/username- Specific mailbox detailsaliases://domain.com- All aliases for a domainidentities://domain.com/mailbox- Identities for a mailboxforwardings://domain.com/mailbox- Forwarding rules for a mailboxrewrites://domain.com- Rewrite rules for a domain
Technical Notes
- The server handles Migadu's API quirks automatically (like 500 status codes on successful deletions)
- All operations include proper error handling and progress reporting
- Built with FastMCP for reliable MCP integration
- Supports bulk operations with intelligent batching
Development
# Clone the repository
git clone https://github.com/Michaelzag/migadu-mcp.git
cd migadu-mcp
# Install dependencies
uv sync --group dev
# Run tests
uv run pytest
# Run quality checks
uv run ruff format --check .
uv run ruff check .
uv run mypy migadu_mcp/
License
MIT License - see LICENSE file for details.
Metadata
Release files for iflow-mcp_michaelzag-migadu-mcp 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_michaelzag_migadu_mcp-1.0.0.tar.gz | 60.6 kB | Without provenance | Details for iflow_mcp_michaelzag_migadu_mcp-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_michaelzag_migadu_mcp-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_michaelzag_migadu_mcp-1.0.0-py3-none-any.whl |
Total release size: 96.4 kB
Release files / iflow_mcp_michaelzag_migadu_mcp-1.0.0.tar.gz
| Download URL | iflow_mcp_michaelzag_migadu_mcp-1.0.0.tar.gz |
|---|---|
| Size | 60.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a733c7e8f597a9c202f49cf7a5fb43f8abab875bdd7b705198256206fff861a4
|
|
BLAKE2b-256 checksum How to use checksums |
0faf45a50260dfc09bfdf871e40f6db6fc2958f7412f1e3e9158cca57dbccd45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_michaelzag_migadu_mcp-1.0.0-py3-none-any.whl
| Download URL | iflow_mcp_michaelzag_migadu_mcp-1.0.0-py3-none-any.whl |
|---|---|
| Size | 35.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
48ba39ccc35497b04117c2bc2fd6ca88fdd2d97ca5e1b569af13b92c40bbf0ef
|
|
BLAKE2b-256 checksum How to use checksums |
fbb00c148df1fc31b7cdef60532f67a962b324b6d5101246d2a3e9588ddbd8f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_michaelzag-migadu-mcp 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.