Migadu

This MCP server lets an AI assistant manage Migadu email hosting by connecting to Migadu through a structured MCP interface. You can create and manage mailboxes, aliases, identities, autoresponders, and routing rules directly from your AI assistant, saving time and reducing manual clicks.

How to use

You connect your MCP client to the Migadu MCP Server and provide the required environment values for authentication. Once connected, you can instruct your AI to perform common email-organization tasks such as creating mailboxes, setting up aliases, configuring autoresponders, and managing identities. The server handles operations in scalable batches and reports progress and errors clearly, so you know what happened after each request.

How to install

# prerequisites: ensure you have the MCP runtime available (uvx) on your system

# 1) Clone the Migadu MCP server repository
git clone https://github.com/Michaelzag/migadu-mcp.git
cd migadu-mcp

# 2) Install development dependencies (adjust if you have a different setup)
uv sync --group dev

# 3) Run tests to verify the server environment
uv run pytest

# 4) Run quality checks (optional but recommended)
uv run ruff format --check .
uv run ruff check .
uv run mypy migadu_mcp/

# 5) Start the Migadu MCP server (example runtime usage)
# Ensure you provide the required Migadu credentials via environment variables
MIGADU_EMAIL=admin@yourdomain.com \
MIGADU_API_KEY=your-api-key \
MIGADU_DOMAIN=yourdomain.com \
uvx migadu-mcp

Configuration and operation notes

Environment variables you must provide to run the Migadu MCP server are shown here. These values connect the MCP server to your Migadu account and domain. Use placeholders until you replace them with your actual credentials.

• MIGADU_EMAIL: The admin email for your Migadu account.
• MIGADU_API_KEY: Your Migadu API key.
• MIGADU_DOMAIN: The domain you manage with Migadu.

Examples of what you can manage with the Migadu MCP Server

Through the MCP interface, you can perform a wide range of actions, including creating mailboxes, deleting mailboxes, listing mailboxes, configuring aliases and forwarding, updating identities, and setting up autoresponders. You can also manage complex routing rules and external forwardings to streamline how email is delivered to your users.

Available tools

list_mailboxes

Return a list of all mailboxes for a domain or account.

list_my_mailboxes

Return a list of mailboxes associated with the authenticated user or domain.

get_mailbox

Fetch detailed information for a specific mailbox.

get_my_mailbox

Fetch detailed information for a mailbox associated with the authenticated user.

create_mailbox

Create a new mailbox with specified attributes like name and password.

update_mailbox

Modify settings for an existing mailbox, such as quota or permissions.

delete_mailbox

Remove a mailbox from the system.

bulk_delete_mailboxes

Delete multiple mailboxes in a single operation.

reset_mailbox_password

Reset the mailbox password.

set_autoresponder

Configure an autoresponder message for a mailbox.

list_aliases

List all email aliases for a domain.

create_alias

Create an email alias that forwards to one or more destinations.

update_alias

Update the destination or settings for an existing alias.

delete_alias

Remove an email alias.

list_identities

List all sending identities for a mailbox or domain.

create_identity

Add a new sending identity (from/address) for a mailbox.

update_identity

Change permissions or settings for an existing identity.

delete_identity

Remove a sending identity.

list_rewrites

View pattern-based routing rules for a domain.

create_rewrite

Set up a new rewrite rule to route emails based on patterns.

update_rewrite

Modify an existing rewrite rule.

delete_rewrite

Delete a rewrite rule.

list_forwardings

View external forwarding rules for a mailbox or domain.

create_forwarding

Create a forwarding rule to deliver emails to external addresses.

update_forwarding

Change details of an existing forwarding rule.

delete_forwarding

Remove a forwarding rule.