# Mail-in-a-Box MCP for AI Agents AI Agent Connect

> Mail-in-a-Box MCP lets you manage your private email instance using natural language. It connects your AI agent to the Mail-in-a-Box REST API so you can create mailboxes, handle forwarding aliases, and check infrastructure health without leaving your chat interface. It's the fastest way to handle email infrastructure tasks.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_97zoxuoeEjuuPbMDKKGoSZNXF3IIT7shhlTFbzSa/ai-agent-connect
- **Tags:** email-server, user-administration, dns-management, system-health, private-email, mailbox-management

## Description

Managing a private email instance usually feels like a chore of constant context switching. You have to log into your admin panel, find the right tab, and manually type in new user details or forwarding rules every time a new team member joins or a client needs a new alias. It's tedious and easy to make mistakes when you're doing it dozens of times a month. This Connector changes that by letting your AI agent handle the heavy lifting for you. Instead of navigating a web UI, you can just tell your agent to set up a new mailbox or update an alias. You can also keep an eye on your instance's health or list your hosted domains on the fly. Because it hooks into the Mail-in-a-Box REST API, it handles the actual execution while you just provide the instructions. It's one of the many high-quality connectors available in the Vinkius catalog, making it easy to plug your existing infrastructure into your favorite AI client. You get to keep your privacy and your custom email setup while making the administration side feel like a conversation rather than a chore.

## Tools

### list_mail_aliases
See every forwarding rule and alias currently active on your instance.

### list_mail_domains
Get a full list of all domains and subdomains hosted on your Mail-in-a-Box instance.

### delete_mail_alias
Remove a specific forwarding alias from your system.

### delete_mail_user
Delete a mail user and their associated mailbox from the instance.

### update_user_password
Change the password for an existing mail user.

### create_mail_user
Create a new mail user with a specific email address and password.

### get_system_status
Check the current health and status of your Mail-in-a-Box system.

### create_or_update_alias
Add a new mail alias or update an existing one to forward to a list of emails.

### list_mail_users
View all mail users currently registered on your instance.

## Prompt Examples

**Prompt:** 
```
What's the status of my mail instance?
```

**Response:** 
```
### System Status Report
I've checked the Mail-in-a-Box system for you. Here is the current status:

| Service | Status | Notes |
| :--- | :--- | :---|
| **DNS** | ✅ Running | All records are valid |
| **IMAP** | ✅ Running | Accessible for clients |
| **SMTP** | ✅ Running | Mail delivery is active |

*Note: There are 2 minor OS updates available for your instance.*
```

**Prompt:** 
```
Add a new user for the support team: support@company.com with password SupportPass123!
```

**Response:** 
```
✅ **Success**
I've created the new mailbox for **support@company.com**. 

**Account Details:**
- **Username:** support@company.com
- **Status:** Active
- **Access:** IMAP/SMTP/Webmail enabled

You can now share these credentials with the support team.
```

**Prompt:** 
```
List all the domains I have hosted.
```

**Response:** 
```
Here are the domains currently configured on your Mail-in-a-Box instance:

* **company.com**
* **dev.company.com**
* **marketing.company.io**
* **backup.company.com**
```

## Capabilities

### Create new mailboxes
Add a new user to your email instance with a full address and password.

### Manage forwarding aliases
Create or update email aliases to route messages to different addresses.

### Check infrastructure health
Get real-time status updates and diagnostic checks for your mail setup.

### List mail domains
View all the domains and subdomains currently hosted on your instance.

### Update user passwords
Change the login credentials for existing mail users instantly.

### Delete mail users
Remove old accounts or mailboxes from your instance.

## Use Cases

### New Employee Onboarding
An IT manager asks the agent to create a mailbox for a new hire using create_mail_user.

### Alias Cleanup
A sysadmin asks the agent to find and delete old forwarding rules using list_mail_aliases and delete_mail_alias.

### Infrastructure Maintenance
A DevOps engineer asks the agent to check if the mail instance is running correctly using get_system_status.

### Domain Audit
A privacy team asks the agent to list all subdomains to ensure no unauthorized domains are active using list_mail_domains.

## Benefits

- Stop clicking through dashboards to create mailboxes by using create_mail_user to add users instantly.
- Manage complex forwarding rules faster by using create_or_update_alias to handle multiple destinations.
- Keep a pulse on your infrastructure with get_system_status to see real-time health reports.
- Quickly audit your setup by using list_mail_domains to see every hosted domain in one view.
- Simplify user management by using list_mail_users and update_user_password to handle account requests.

## How It Works

The bottom line is you get a natural language interface for your entire email instance backend.

1. Subscribe to the Mail-in-a-Box MCP in the Vinkius marketplace.
2. Provide your Host, Admin Email, and Admin Password or API Key.
3. Ask your AI client to perform tasks like creating a user or checking system status.

## Frequently Asked Questions

**Can I use Mail-in-a-Box MCP to create new email accounts?**
Yes, you can use it to create new mailboxes for your team by providing the email address and password in plain text.

**Does Mail-in-a-Box MCP work with my existing private server?**
Yes, it connects directly to your existing Mail-in-a-Box instance to manage your existing infrastructure.

**How do I manage email aliases with this Connector?**
You can create or update forwarding rules by telling your agent which email address should route to which destination.

**Can I check my server's health using Mail-in-a-Box MCP?**
Yes, it can pull real-time diagnostic data to show you if your mail services like DNS and SMTP are running correctly.

**Does this Connector let me read my emails?**
No, this Connector is designed for backend administration tasks like user management and system monitoring, not for reading personal messages.

**Is it safe to use my admin password with this Connector?**
For better security, it's recommended to use an API key from your Mail-in-a-Box dashboard rather than your primary admin password.

**What format is required for the instance host?**
Provide the full hostname without the 'https://' prefix, for example: `box.yourdomain.com`.

**Can I add multiple forwarding targets to an alias?**
Yes, when using the `create_or_update_alias` tool, provide a comma-separated list of emails in the `forwards_to` field.

**Does this work with 2FA enabled accounts?**
The current API implementation uses Basic Auth. If 2FA is enabled on your admin account, you may need to use an API key or a dedicated admin user without 2FA for the integration.