Migadu MCP

🚀 Migadu MCP Server

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

🚀 Quick Start

Migadu MCP Server allows you to manage your Migadu email hosting via AI assistants using the Model Context Protocol (MCP). Instead of manually operating through web interfaces, you can use AI to handle various email - related tasks.

✨ Features

What is Migadu?

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

What This Does

This MCP server enables AI assistants to manage your Migadu email accounts. You can ask your AI to perform the following tasks:

• 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 questions 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 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

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