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.