migadu-mcp 3.3.0

Professional FastMCP server for comprehensive Migadu email management with Context logging, tool annotations, and testing infrastructure

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": "[e-mail]",
        "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 [e-mail] with the name John Smith"
• "List all mailboxes on my domain"
• "Set up an email alias [e-mail] that forwards to [e-mail]"
• "Delete the mailboxes for employees who left: [e-mail], [e-mail]"
• "Create an autoresponder for [e-mail]"

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.