Migadu MCP

🚀 Migadu MCP Server

Control your Migadu email hosting through AI assistants using the Model Context Protocol (MCP).

🚀 Quick Start

This MCP server enables AI assistants to manage your Migadu email accounts. Instead of navigating through web interfaces, you can instruct your AI to perform various email - related tasks.

✨ Features

What is Migadu?

Migadu is a Swiss email hosting service. It offers unlimited email addresses, and its pricing is based on actual usage rather than the number of mailboxes. Focusing on standard email protocols (SMTP/IMAP/POP3) without vendor lock - in, it is popular among developers and privacy - conscious users.

What This Does

• Create and delete mailboxes
• Set up email aliases and forwarding rules
• Configure autoresponders
• Manage multiple email identities
• Handle bulk operations efficiently

📦 Installation

Add the following 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.

💻 Usage Examples

Basic Usage

Once configured, you can ask your AI assistant commands 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"

📚 Documentation

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 Details

• The server automatically handles Migadu's API quirks (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

This project is under the MIT License. See the LICENSE file for details.