Mail-in-a-Box Connector for AI agents.
9 live capabilities
Manage your private email instance and mailboxes with natural language commands.
Waiting for input…
Why people use Mail-in-a-Box
Mail-in-a-Box Email Instance Management for Admins
This Connector changes that by putting the power of the Mail-in-a-Box REST API into your chat interface. You can just tell your agent to create a new mailbox or update a password, and it handles the backend calls for you. You get to stay in your flow while the agent handles the heavy lifting of instance administration.
What Vinkius changes
You get a natural language interface for your entire email instance backend.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
New Employee Onboarding
An IT manager asks the agent to create a mailbox for a new hire using create_mail_user.
- Real-world use case 02
Alias Cleanup
A sysadmin asks the agent to find and delete old forwarding rules using list_mail_aliases and delete_mail_alias.
- Real-world use case 03
Infrastructure Maintenance
A DevOps engineer asks the agent to check if the mail instance is running correctly using get_system_status.
Complete set · 9capabilities
The complete Mail-in-a-Box capability set.
These are the exact actions your AI can choose when you ask it to work with Mail-in-a-Box.
01—03
3 capabilities in this set.
Part of 9 available through Mail-in-a-Box.
- 01 Capability
List mail aliases
See every forwarding rule and alias currently active on your instance.
- 02 Capability
List mail domains
Get a full list of all domains and subdomains hosted on your Mail-in-a-Box instance.
- 03 Capability
Delete mail alias
Remove a specific forwarding alias from your system.
04—06
3 capabilities in this set.
Part of 9 available through Mail-in-a-Box.
- 04 Capability
Delete mail user
Delete a mail user and their associated mailbox from the instance.
- 05 Capability
Update user password
Change the password for an existing mail user.
- 06 Capability
Create mail user
Create a new mail user with a specific email address and password.
07—09
3 capabilities in this set.
Part of 9 available through Mail-in-a-Box.
- 07 Capability
Get system status
Check the current health and status of your Mail-in-a-Box system.
- 08 Capability
Create or update alias
Add a new mail alias or update an existing one to forward to a list of emails.
- 09 Capability
List mail users
View all mail users currently registered on your instance.
Set up in minutes
One URL. Then ask Mail-in-a-Box to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Mail-in-a-Box from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_97zoxuoeEjuuPbMDKKGoSZNXF3IIT7shhlTFbzSa/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Mail-in-a-Box, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Mail-in-a-Box for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_97zoxuoeEjuuPbMDKKGoSZNXF3IIT7shhlTFbzSa/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Mail-in-a-Box URL.
- Step 03
Save and start
Save the connection and enable Mail-in-a-Box in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"mail-in-a-box": {
"url": "https://edge.vinkius.com/vk_preview_97zoxuoeEjuuPbMDKKGoSZNXF3IIT7shhlTFbzSa/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Mail-in-a-Box
Open Agent mode in chat and ask: "Using Mail-in-a-Box, help me...". 9 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"mail-in-a-box": {
"url": "https://edge.vinkius.com/vk_preview_97zoxuoeEjuuPbMDKKGoSZNXF3IIT7shhlTFbzSa/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Mail-in-a-Box
Ask Copilot: "Using Mail-in-a-Box, help me...". 9 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"mail-in-a-box": {
"url": "https://edge.vinkius.com/vk_preview_97zoxuoeEjuuPbMDKKGoSZNXF3IIT7shhlTFbzSa/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Mail-in-a-Box
Open Cascade and ask: "Using Mail-in-a-Box, help me...". 9 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"mail-in-a-box": {
"url": "https://edge.vinkius.com/vk_preview_97zoxuoeEjuuPbMDKKGoSZNXF3IIT7shhlTFbzSa/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Mail-in-a-Box
Ask Cline: "Using Mail-in-a-Box, help me...". 9 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add mail-in-a-box --transport http "https://edge.vinkius.com/vk_preview_97zoxuoeEjuuPbMDKKGoSZNXF3IIT7shhlTFbzSa/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Mail-in-a-Box
Ask Claude: "Using Mail-in-a-Box, show me...". 9 tools are ready
Where the request belongs
Work Mail-in-a-Box can move forward.
This is for the sysadmin who's tired of manual ticket fulfillment for new email accounts and the DevOps engineer who wants to automate user onboarding for a privacy-focused company.
System Administrator
Manages user requests and alias updates via chat instead of a web dashboard.
DevOps Engineer
Automates the creation of mailboxes during new employee onboarding.
IT Manager
Monitors instance health and domain lists across multiple projects.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsAfterLogic Aurora
Email and webmail management. manage folders, messages, and accounts via AI.
Mailinator
Test email workflows with disposable inboxes that catch every message without touching production mailboxes or real addresses.
Elastic Email
Equip your AI agent to manage email campaigns, track contacts, and monitor delivery logs via the Elastic Email API.
Mailgun (Transactional Email & Domains)
Manage email infrastructure via Mailgun. send transactional emails, monitor domain health, and audit delivery logs.
MailSlurp
Manage temporary inboxes and automate email testing via the MailSlurp REST API.
UK Postbox
Manage your virtual mailbox via UK Postbox u2014 scan letters, forward mail, send correspondence, and track parcels from your AI agent.
Bring your own AI
Change the model, client or framework. Keep Mail-in-a-Box connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Mail-in-a-Box.
The practical details behind the request, access and result.
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 capability, 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.
One connection away
Give your agent a direct line to Mail-in-a-Box.
Connect Mail-in-a-Box once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available