Mail-in-a-Box MCP. Manage mail users and aliases with natural language commands.

You run a private email server, and you don't wanna live in the dashboard or mess around with API endpoints just to manage users. This MCP Server gives your AI agent direct command access to Mail-in-a-Box. It handles everything—from adding new mailboxes to fixing forwarding rules—all through natural language prompts.

You just talk to your agent, and it executes the necessary commands against your live server instance.

Managing User Accounts: The core capability here lets you control every user on your system. To get started, the create_mail_user tool handles adding a new mailbox; you provide the full email address and set the initial password, and that account is live. If someone changes their mind or needs to change their login credentials, you'll use update_user_password to reset it without touching the actual user profile.

When an account is done for good, delete_mail_user permanently removes the mailbox and associated data from the server. To keep track of who’s actually on board, you can always run list_mail_users, which gathers a full roster of every active mail user currently set up on your instance.

Handling Email Aliases: Forwarding addresses are crucial for any serious email setup. The agent manages these rules using create_or_update_alias; this tool lets you either establish a brand-new forwarding address or modify an existing one, ensuring incoming messages get sent to the right place or multiple places. If an alias gets messed up or is no longer needed, you just run delete_mail_alias and it removes that specific forwarding rule from your server configuration.

You can see exactly what's set up by using list_mail_aliases, which pulls together a complete list of every current alias and shows where each one directs mail.

Listing Domains and Diagnosing Status: Before you change anything, you need to know what’s running. The list_mail_domains tool returns a comprehensive inventory of every domain name configured on the server instance. This is your quick check to make sure all your intended domains are recognized by Mail-in-a-Box. To see how healthy the whole setup is, run get_system_status.

That checks the overall operational status of the entire email server stack, giving you real-time diagnostic information on performance and service health.

This set of tools means your AI client doesn't just read data; it acts. It executes direct administrative changes. You get to manage user accounts, control every alias forwarding rule, and check system diagnostics—all without ever opening a dashboard or writing an API call. It’s pure automation for hardcore email admin work.