Manage mail users and aliases with natural language commands.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Q: How do I list every user mailbox using the listmailusers tool?

Just ask your agent to run listmailusers. It retrieves a full roster of all active mail users configured on the server. This is faster than logging into the web UI.

Q: I need to change an alias; should I use deletemailalias or createorupdatealias?

It's best practice to run listmailaliases first so you know exactly what you’re working with. Then, if the rule is wrong, use createorupdatealias—it handles both setting up new rules and updating existing ones.

Q: What should I do to reset a user's password? Is there a specific tool?

Use the updateuserpassword tool. You just give the agent the username and the new temporary password, and it handles the change securely.

Q: If I delete a user mailbox with deletemailuser, is that permanent?

Yes, using deletemailuser removes the account entirely. Always verify your list of users first by running listmailusers to make sure you're targeting the right account.

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

Mail-in-a-Box MCP Server automates private email server administration. Your AI agent connects directly to your Mail-in-a-Box instance, giving it tools to handle user creation, password resets, and alias management via natural language commands.

This lets you manage mailboxes and monitor system health without ever touching a dashboard or API client.

What your AI can do

Create mail user

Adds a new user mailbox by providing a full email address and setting a password.

List mail aliases

Retrieves a complete list of all current mail aliases and where they forward to.

List mail domains

Returns a comprehensive list of every domain name hosted on the server instance.

+ 6 more capabilities included

Manage User Accounts

The agent can create, read, update, and delete entire mail user accounts.

Handle Email Aliases

You can add new forwarding aliases, remove old ones, or list all existing addresses that redirect mail.

Diagnose Server Status

The agent retrieves the real-time health status and diagnostic information for the entire email server stack.

List Hosted Domains

You can get a list of all domains that are currently configured to run on the instance.

Ask an AI about this

Compatible AI Apps

OAuth 2.0 Compatible

Claude

ChatGPT

Cursor

Gemini

VS Code

JetBrains

Vercel

Zendesk

+ any other MCP app

Included with Plan

Waiting for input…

AI Agent

Mail-in-a-Box MCP Server: 9 Tools for Mail Management

Use these tools to programmatically manage user accounts, aliases, and monitor the health of your self-hosted email server.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Mail-in-a-Box on Vinkius

Create Mail User

Adds a new user mailbox by providing a full email address and setting a password.

List Mail Aliases

Retrieves a complete list of all current mail aliases and where they forward to.

List Mail Domains

Returns a comprehensive list of every domain name hosted on the server instance.

Delete Mail Alias

Removes a specific forwarding address (alias) from the server configuration.

Delete Mail User

Permanently removes an existing user account and its associated mailbox.

Update User Password

Changes the password for an existing user mailbox without deleting the account.

Get System Status

Checks the overall operational status of the entire Mail-in-a-Box server system.

Create Or Update Alias

Changes or sets up an email alias so incoming messages forward to one or more...

List Mail Users

Gathers and displays a full roster of all active mail users currently set up on the...

Connect to your AI in seconds. Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The Mail-in-a-Box integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "mail-in-a-box": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the Mail-in-a-Box tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"mail-in-a-box": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with Mail-in-a-Box, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 5,000+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mail-in-a-Box. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 9 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Managing user accounts and aliases shouldn't feel like navigating a decade-old web control panel.

Right now, updating even a simple alias means logging into the Mail-in-a-Box UI. You find the domain, click 'Aliases,' search for the group, manually edit the forwarding rule, and hit save. If you have fifty users or need to update three different domains, that's 50 clicks and at least an hour of tedious copy/pasting across multiple tabs.

With this MCP server, you just tell your agent: 'Update the alias for sales@company.com to forward everything to team-a@corp.com.' The agent runs `create_or_update_alias` in one go. You get confirmation and move on. It's simple.

Mail-in-a-Box MCP Server: Manage mail users and aliases

Gone are the days of having to manually check server logs or running multiple dashboard reports just to verify if everything is up. Checking status requires jumping between DNS records, service monitors, and user lists—a painful process that always leaves you guessing.

Now, asking 'How's the system?' gets a single call: `get_system_status`. You get immediate confirmation on whether IMAP, SMTP, and all core services are running. No guesswork, just facts.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

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.

Built · Hosted · Managed by Vinkius Mail-in-a-Box MCP Server - Manage Mail Users and Aliases

Server ID 019d75cc-2c3d-73b4-98bc-13a9f690d481

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

Here's how it actually works

The bottom line is: You talk to your AI client like you're talking to a system admin, and it runs the necessary commands on your private email server.

Subscribe to this server and provide your Mail-in-a-Box Host credentials (Admin Email/API Key).

Your AI agent sends a natural language request, which triggers the appropriate tool (e.g., create_mail_user).

The tool executes against your live server and returns structured data or confirmation to the agent for you to review.

Who is this actually for?

This tool targets people who run critical communication infrastructure. Think of the DevOps engineer stuck in a manual loop: they gotta list 50 users, check passwords for 3 of them, and update an alias across three domains—all before lunch. This lets them do that via conversation.

System Administrator

Manages user accounts and forwarding rules without needing to write shell scripts or use the web UI.

DevOps Engineer

Automates user onboarding, checks system health (get_system_status), and manages infrastructure changes from their dev tools.

Security Auditor

Needs to quickly audit all active mail users or check if any administrative privileges need adjustment across the server.

What Changes When You Connect

Automate user management. Instead of running a console command to create a mailbox, you just ask your agent to 'create a new account for support@company.com,' using create_mail_user.

Handle complex forwarding rules instantly. Use create_or_update_alias to set up an alias that sends mail to three different team members simultaneously—no manual list editing required.

Get instant system diagnostics. Need to know if the server is healthy? Just run get_system_status. It pulls all core service metrics without you needing to log into a dashboard.

Maintain domain visibility. With list_mail_domains, you instantly see every single domain hosted on your instance, making audits much faster than digging through configuration files.

Streamline account lifecycle. If an employee leaves, instead of manually deleting them from multiple places, use delete_mail_user and delete_mail_alias in two prompts.

See it in action

01 01

New Employee Onboarding

The ops engineer needs to onboard a new manager. They ask the agent, 'Create user 'manager@corp.com' and set their password.' The agent runs create_mail_user and confirms success. Next, they ask, 'Make sure that alias also forwards to the sales team,' running create_or_update_alias. Done in three steps.

02 02

Security Audit of Accounts

The security auditor needs a full roster and status check. They prompt, 'List all users and then tell me the system health.' The agent runs list_mail_users to get the list, and immediately follows up with get_system_status to ensure no service is down.

03 03

Fixing a Broken Forwarder

A marketing team member reports that 'old-info@corp.com' isn't forwarding mail correctly. They ask the agent, 'Check and fix the alias for old-info.' The agent runs list_mail_aliases to verify the current setup, then uses delete_mail_alias followed by create_or_update_alias to correct it.

04 04

Server Health Check

The DevOps team notices suspicious activity. They ask the agent for a full report. The agent runs get_system_status, which verifies if DNS, IMAP, and SMTP services are running correctly before alerting the team.

The honest tradeoffs

Trying to manage everything in one API call

Anti-pattern

The user tries to send a single prompt like: 'Make sure user X is created, alias Y forwards, and check the server status.' The underlying system might fail because it's mixing three distinct actions.

The Fix

Break it down. First, use create_mail_user for the account. Second, run list_mail_aliases to verify the existing rules. Third, if needed, run update_user_password in a separate prompt.

Guessing which tool to call

Anti-pattern

The user asks: 'What are my domains?' and doesn't mention it needs a list of hosted domains. They might only get a partial answer, missing critical configuration data.

The Fix

Be specific. Always ask the agent to run list_mail_domains when you need confirmation on what domains are live.

Forgetting to check status after changes

Anti-pattern

After manually running a user deletion, the system might throw an error because another service still references that deleted mailbox. The failure point is often missed.

The Fix

Always run get_system_status immediately after any major change (like deleting users or aliases) to confirm all core services are stable.

When It Fits, When It Doesn't

Use this server if your primary need is automating routine administrative tasks on a private, self-hosted email platform. You need the agent to handle CRUD operations for mail users and aliases—specifically when you need create_mail_user, delete_mail_user, or list_mail_aliases frequently.

You don't use this if: 1) Your company uses a major cloud provider (like Microsoft Exchange or Google Workspace); those systems have their own APIs. 2) You only need to check DNS records; run a dedicated DNS tool instead of relying on get_system_status. This server is for internal, low-level management of the mail stack itself.

Questions you might have

How do I list every user mailbox using the list_mail_users tool? +

Just ask your agent to run list_mail_users. It retrieves a full roster of all active mail users configured on the server. This is faster than logging into the web UI.

I need to change an alias; should I use delete_mail_alias or create_or_update_alias? +

It's best practice to run list_mail_aliases first so you know exactly what you’re working with. Then, if the rule is wrong, use create_or_update_alias—it handles both setting up new rules and updating existing ones.

What should I do to reset a user's password? Is there a specific tool? +

Use the update_user_password tool. You just give the agent the username and the new temporary password, and it handles the change securely.

If I delete a user mailbox with delete_mail_user, is that permanent? +

Yes, using delete_mail_user removes the account entirely. Always verify your list of users first by running list_mail_users to make sure you're targeting the right account.

If I run `get_system_status`, what kind of diagnostics does it report on my Mail-in-a-Box system? +

It provides a real-time health check. You'll see if all core services, like IMAP and SMTP, are running correctly. The tool also flags available OS updates or minor configuration issues.

When using `create_mail_user`, what inputs does the tool require to successfully create a new mailbox? +

You must provide two things: a full, unique email address and a secure password. The tool then handles creating the user account, allowing them immediate access via IMAP/SMTP or webmail.

How do I use `list_mail_domains` to see all hosted domains on my server? +

The function returns a comprehensive list of every mail domain and subdomain configured on your instance. This helps you quickly verify the scope of email addresses managed by this server.

If I use `list_mail_aliases`, what exactly does that tool display about my forwarding setup? +

It returns a list of every defined alias and specifies which emails it forwards to. This is useful for auditing your entire system's email redirection rules at a glance.

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.

Connect to your AI in seconds.

Create mail user

List mail aliases

List mail domains

Mail-in-a-Box MCP Server: 9 Tools for Mail Management

Make your AI actually useful.

Create Mail User

List Mail Aliases

List Mail Domains

Delete Mail Alias

Delete Mail User

Update User Password

Get System Status

Create Or Update Alias

List Mail Users

Connect to your AI in seconds. Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Managing user accounts and aliases shouldn't feel like navigating a decade-old web control panel.

Mail-in-a-Box MCP Server: Manage mail users and aliases

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

New Employee Onboarding

Security Audit of Accounts

Fixing a Broken Forwarder

Server Health Check

The honest tradeoffs

Trying to manage everything in one API call

Guessing which tool to call

Forgetting to check status after changes

When It Fits, When It Doesn't

Questions you might have