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 mailboxes
get_mailbox / get_my_mailbox - Get mailbox details
create_mailbox / create_my_mailbox - Create new mailboxes
update_mailbox - Change mailbox settings
delete_mailbox - Remove mailboxes
bulk_delete_mailboxes - Delete multiple mailboxes at once
reset_mailbox_password - Change passwords
set_autoresponder - Configure out-of-office messages

Email Routing

list_aliases / list_my_aliases - View email aliases
create_alias - Set up email forwarding without creating a mailbox
update_alias - Change alias destinations
delete_alias - Remove aliases

Identity Management

list_identities - View send-as addresses
create_identity - Add additional sending addresses
update_identity - Modify identity permissions
delete_identity - Remove identities

Advanced Routing

list_rewrites - View pattern-based routing rules
create_rewrite - Set up wildcard email routing
update_rewrite - Modify routing patterns
delete_rewrite - Remove routing rules

External Forwarding

list_forwardings - View external forwarding rules
create_forwarding - Forward emails to external addresses
update_forwarding - Change forwarding settings
delete_forwarding - Remove forwarding rules

MCP Resources

Access structured data through these resource URIs:

mailboxes://domain.com - All mailboxes for a domain
mailbox://domain.com/username - Specific mailbox details
aliases://domain.com - All aliases for a domain
identities://domain.com/mailbox - Identities for a mailbox
forwardings://domain.com/mailbox - Forwarding rules for a mailbox
rewrites://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.